Skip to main content
Retrieve a list of projects within an organization. You can filter projects by state and paginate through results.

​
Path Parameters

​
org_id
string
required
Organization ID to list projects from. Must be a valid UUID.

​
Query Parameters

​
state
string
Filter projects by state. Valid values are enabled or disabled.

​
Response

​
projects
array
Array of project objects matching the filter criteria.
​
id
string
Unique identifier for the project (UUID format).
​
name
string
Unique name/slug for the project. Used in URLs and API calls.
​
title
string
Human-readable display name for the project.
​
org_id
string
ID of the organization this project belongs to.
​
metadata
object
Custom metadata associated with the project. Can contain any valid JSON structure.
​
created_at
timestamp
Timestamp when the project was created (RFC3339 format).
​
updated_at
timestamp
Timestamp when the project was last updated (RFC3339 format).
​
members_count
integer
Number of members in the project.
curl -X GET 'https://api.frontier.example.com/v1beta1/organizations/9f256f86-d3c4-4a6e-b89a-1e9a23c5d78e/projects?state=enabled' \
  -H 'Authorization: Bearer <token>'

​
Response Example

{
  "projects": [
    {
      "id": "3f4a5b6c-7d8e-9f0a-1b2c-3d4e5f6a7b8c",
      "name": "data-platform",
      "title": "Data Platform",
      "org_id": "9f256f86-d3c4-4a6e-b89a-1e9a23c5d78e",
      "metadata": {
        "team": "engineering",
        "department": "data"
      },
      "created_at": "2024-01-20T09:15:00Z",
      "updated_at": "2024-02-15T14:30:00Z",
      "members_count": 12
    },
    {
      "id": "8c9d0e1f-2a3b-4c5d-6e7f-8a9b0c1d2e3f",
      "name": "mobile-app",
      "title": "Mobile Application",
      "org_id": "9f256f86-d3c4-4a6e-b89a-1e9a23c5d78e",
      "metadata": {
        "team": "mobile",
        "platform": "ios-android"
      },
      "created_at": "2024-02-01T11:20:00Z",
      "updated_at": "2024-02-28T16:45:00Z",
      "members_count": 8
    }
  ]
}

​
Error Responses

​
code
string
Error code indicating the type of error.
​
message
string
Human-readable error message.

​
Common Errors

  • 400 Bad Request: Invalid organization ID format
  • 401 Unauthorized: Invalid or missing authentication token
  • 404 Not Found: Organization not found
  • 500 Internal Server Error: Server encountered an unexpected error

​
Notes

  • Results are returned in no guaranteed order unless sorting is implemented
  • Empty results return an empty array, not an error
  • Disabled projects are only returned when explicitly filtering by state=disabled
  • The members_count field shows the total number of users with access to the project

Build docs developers (and LLMs) love

Get started for freeTalk to us