API ReferenceProjects

List all projects

Markdown
GET
/api/v3/org/owner/project/list

Retrieves all projects belonging to the authenticated organization. Projects are returned in descending order of creation date (newest first). This endpoint is useful for displaying project selection in dashboards or for integrations that need to list all available projects.

Authorization

OrgApiKeyAuth
x-org-api-key<token>

Organization API key authentication

In: header

Query Parameters

limit?number|null

Number of items per page, max allowed is 1000

cursor?string

Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/org/owner/project/list"
{
  "data": [
    {
      "id": "proj_abc123xyz456",
      "org_id": "org_abc123xyz456",
      "name": "My Awesome Project",
      "email": "project-123@composio.dev",
      "created_at": "2023-05-16T14:30:00.000Z",
      "updated_at": "2023-05-18T09:15:30.000Z",
      "webhook_url": "https://example.com/webhook",
      "event_webhook_url": "https://example.com/events",
      "webhook_secret": "whsec_abcdef123456789",
      "triggers_enabled": true,
      "last_subscribed_at": "2023-05-17T10:00:00.000Z",
      "is_new_webhook": true,
      "webhook_version": "V2",
      "deleted": false
    }
  ],
  "next_cursor": "string",
  "total_pages": 0,
  "current_page": 0,
  "total_items": 0
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}