Projects

Get project details by ID With Org Api key

Changed on

Retrieves detailed information about a specific project using its unique identifier. This endpoint provides complete project configuration including webhook URLs, creation and update timestamps, and webhook secrets. Use this endpoint to inspect project settings or verify project configuration.

get/api/v3.1/org/owner/project/{nano_id}

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/org/owner/project/{nano_id}
  • Auth
    API key in header x-org-api-key

Path parameters

nano_idstring projectId required

Unique identifier (Nano ID) of the project to retrieve

Example:pr_1a2b3c4d5e6f

Response

Project retrieved successfully. Returns a complete project object with all configuration details and associated API keys.

idstring projectId required

Unique identifier for the project

org_idstring orgId required

Identifier of the organization that owns this project

namestring required

Name of the project

emailstring required

Email address associated with the project

created_atstring required

ISO timestamp when the project was created

updated_atstring required

ISO timestamp when the project was last updated

webhook_urlstring uri nullable required

DEPRECATED: Use GET /api/v3/webhook_subscriptions instead. Legacy project-level webhook URL.

event_webhook_urlstring uri nullable required

DEPRECATED: No longer used.

webhook_secretstring nullable required

DEPRECATED: Use GET /api/v3/webhook_subscriptions instead. Legacy project-level webhook secret.

triggers_enabledboolean

Whether triggers are enabled for this project

last_subscribed_atstring date-time nullable

ISO timestamp when the project last subscribed to updates

is_new_webhookboolean

Deprecated: Please refer to webhook_version instead. True indicates if the webhook configuration is using the previous new format (V2). False indicates the oldest format (V1)

webhook_version'V1' | 'V2' | 'V3' required

Payload format version for Pusher real-time events only. For webhook configuration, use GET /api/v3/webhook_subscriptions.

deletedboolean required

Whether this project has been deleted

Example response

{
  "id": "pr_1a2b3c4d5e6f",
  "org_id": "ok_1a2b3c4d5e6f",
  "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",
  "api_keys": [
    {
      "id": "01H4DKRF5SMP7NQCA3BWT0JYB6",
      "name": "Production Server Key",
      "key": "ak_**6j0z",
      "created_at": "2023-07-15T14:30:00.000Z"
    }
  ]
}

Changes