Projects
Create
Delete
List
Retrieve
Update
ModelsExpand Collapse
ProjectCreateResponse object { project }
project: object { id, createdAt, keys, 13 more }
keys: array of object { id, apiKeyId, apiKeyStatus, 11 more } The keys of the project (get from the ProjectRoles table)
The keys of the project (get from the ProjectRoles table)
The key’s member id (its API user id, apiu_...), taken by the member and
usage routes (example: “apiu_eyVcnFJcR92BxBkz7N6g5w”)
The API key id (api_...), taken by the api-keys routes (example:
“api_eyVcnFJcR92BxBkz7N6g5w”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
scope: "project" or "team"The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The API key last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)
The member who created the key: a human, or the member id (apiu_...) of
the team API key that created it.
The date the API key was last used to authenticate a request, as an ISO string (example: “2023-02-03T11:19:41.579Z”). Absent if the key has never been used.
The key’s effective consumption (CU) cap for the period (per-key override, else the team-wide default). Absent when the key is uncapped.
For a PROJECT key: the project it was created on (the team id on some legacy keys). Absent for team keys.
Whether the project is privacyMode In a privacyMode project, users can only see their own generated assets (except admins)
users: array of object { id, createdAt, email, 5 more } The users of the project (get from the ProjectRoles table)
The users of the project (get from the ProjectRoles table)
The user email (example: “herve@scenario.com”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
High-level markdown description of the project Only returned on single project GET, not on list
ISO string date when the description was last updated Only returned on single project GET, not on list
When true, IP detection is switched off for this project even if the team has an active posture. Absent means the team posture applies. The posture itself (disabled / active-fail-open / active-fail-closed) is a team-level setting, see the team’s ipDetectionEnforcement.
The project’s consumption (CU) cap for the period. Absent when uncapped.
ProjectListResponse object { id, createdAt, keys, 13 more }
keys: array of object { id, apiKeyId, apiKeyStatus, 11 more } The keys of the project (get from the ProjectRoles table)
The keys of the project (get from the ProjectRoles table)
The key’s member id (its API user id, apiu_...), taken by the member and
usage routes (example: “apiu_eyVcnFJcR92BxBkz7N6g5w”)
The API key id (api_...), taken by the api-keys routes (example:
“api_eyVcnFJcR92BxBkz7N6g5w”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
scope: "project" or "team"The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The API key last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)
The member who created the key: a human, or the member id (apiu_...) of
the team API key that created it.
The date the API key was last used to authenticate a request, as an ISO string (example: “2023-02-03T11:19:41.579Z”). Absent if the key has never been used.
The key’s effective consumption (CU) cap for the period (per-key override, else the team-wide default). Absent when the key is uncapped.
For a PROJECT key: the project it was created on (the team id on some legacy keys). Absent for team keys.
Whether the project is privacyMode In a privacyMode project, users can only see their own generated assets (except admins)
users: array of object { id, createdAt, email, 5 more } The users of the project (get from the ProjectRoles table)
The users of the project (get from the ProjectRoles table)
The user email (example: “herve@scenario.com”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
High-level markdown description of the project Only returned on single project GET, not on list
ISO string date when the description was last updated Only returned on single project GET, not on list
When true, IP detection is switched off for this project even if the team has an active posture. Absent means the team posture applies. The posture itself (disabled / active-fail-open / active-fail-closed) is a team-level setting, see the team’s ipDetectionEnforcement.
The project’s consumption (CU) cap for the period. Absent when uncapped.
ProjectRetrieveResponse object { project }
project: object { id, createdAt, keys, 13 more }
keys: array of object { id, apiKeyId, apiKeyStatus, 11 more } The keys of the project (get from the ProjectRoles table)
The keys of the project (get from the ProjectRoles table)
The key’s member id (its API user id, apiu_...), taken by the member and
usage routes (example: “apiu_eyVcnFJcR92BxBkz7N6g5w”)
The API key id (api_...), taken by the api-keys routes (example:
“api_eyVcnFJcR92BxBkz7N6g5w”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
scope: "project" or "team"The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The API key last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)
The member who created the key: a human, or the member id (apiu_...) of
the team API key that created it.
The date the API key was last used to authenticate a request, as an ISO string (example: “2023-02-03T11:19:41.579Z”). Absent if the key has never been used.
The key’s effective consumption (CU) cap for the period (per-key override, else the team-wide default). Absent when the key is uncapped.
For a PROJECT key: the project it was created on (the team id on some legacy keys). Absent for team keys.
Whether the project is privacyMode In a privacyMode project, users can only see their own generated assets (except admins)
users: array of object { id, createdAt, email, 5 more } The users of the project (get from the ProjectRoles table)
The users of the project (get from the ProjectRoles table)
The user email (example: “herve@scenario.com”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
High-level markdown description of the project Only returned on single project GET, not on list
ISO string date when the description was last updated Only returned on single project GET, not on list
When true, IP detection is switched off for this project even if the team has an active posture. Absent means the team posture applies. The posture itself (disabled / active-fail-open / active-fail-closed) is a team-level setting, see the team’s ipDetectionEnforcement.
The project’s consumption (CU) cap for the period. Absent when uncapped.
ProjectUpdateResponse object { project }
project: object { id, createdAt, keys, 13 more }
keys: array of object { id, apiKeyId, apiKeyStatus, 11 more } The keys of the project (get from the ProjectRoles table)
The keys of the project (get from the ProjectRoles table)
The key’s member id (its API user id, apiu_...), taken by the member and
usage routes (example: “apiu_eyVcnFJcR92BxBkz7N6g5w”)
The API key id (api_...), taken by the api-keys routes (example:
“api_eyVcnFJcR92BxBkz7N6g5w”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
scope: "project" or "team"The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The API key last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)
The member who created the key: a human, or the member id (apiu_...) of
the team API key that created it.
The date the API key was last used to authenticate a request, as an ISO string (example: “2023-02-03T11:19:41.579Z”). Absent if the key has never been used.
The key’s effective consumption (CU) cap for the period (per-key override, else the team-wide default). Absent when the key is uncapped.
For a PROJECT key: the project it was created on (the team id on some legacy keys). Absent for team keys.
Whether the project is privacyMode In a privacyMode project, users can only see their own generated assets (except admins)
users: array of object { id, createdAt, email, 5 more } The users of the project (get from the ProjectRoles table)
The users of the project (get from the ProjectRoles table)
The user email (example: “herve@scenario.com”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
High-level markdown description of the project Only returned on single project GET, not on list
ISO string date when the description was last updated Only returned on single project GET, not on list
When true, IP detection is switched off for this project even if the team has an active posture. Absent means the team posture applies. The posture itself (disabled / active-fail-open / active-fail-closed) is a team-level setting, see the team’s ipDetectionEnforcement.
The project’s consumption (CU) cap for the period. Absent when uncapped.
ProjectsBrief
Delete
Retrieve
Update
ModelsExpand Collapse
ProjectsInstructions
ModelsExpand Collapse
ProjectsMembers
Create
Delete
Update
ModelsExpand Collapse
MemberCreateResponse object { project }
project: object { id, createdAt, keys, 13 more }
keys: array of object { id, apiKeyId, apiKeyStatus, 11 more } The keys of the project (get from the ProjectRoles table)
The keys of the project (get from the ProjectRoles table)
The key’s member id (its API user id, apiu_...), taken by the member and
usage routes (example: “apiu_eyVcnFJcR92BxBkz7N6g5w”)
The API key id (api_...), taken by the api-keys routes (example:
“api_eyVcnFJcR92BxBkz7N6g5w”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
scope: "project" or "team"The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The API key last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)
The member who created the key: a human, or the member id (apiu_...) of
the team API key that created it.
The date the API key was last used to authenticate a request, as an ISO string (example: “2023-02-03T11:19:41.579Z”). Absent if the key has never been used.
The key’s effective consumption (CU) cap for the period (per-key override, else the team-wide default). Absent when the key is uncapped.
For a PROJECT key: the project it was created on (the team id on some legacy keys). Absent for team keys.
Whether the project is privacyMode In a privacyMode project, users can only see their own generated assets (except admins)
users: array of object { id, createdAt, email, 5 more } The users of the project (get from the ProjectRoles table)
The users of the project (get from the ProjectRoles table)
The user email (example: “herve@scenario.com”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
High-level markdown description of the project Only returned on single project GET, not on list
ISO string date when the description was last updated Only returned on single project GET, not on list
When true, IP detection is switched off for this project even if the team has an active posture. Absent means the team posture applies. The posture itself (disabled / active-fail-open / active-fail-closed) is a team-level setting, see the team’s ipDetectionEnforcement.
The project’s consumption (CU) cap for the period. Absent when uncapped.
MemberDeleteResponse object { project }
project: object { id, createdAt, keys, 13 more }
keys: array of object { id, apiKeyId, apiKeyStatus, 11 more } The keys of the project (get from the ProjectRoles table)
The keys of the project (get from the ProjectRoles table)
The key’s member id (its API user id, apiu_...), taken by the member and
usage routes (example: “apiu_eyVcnFJcR92BxBkz7N6g5w”)
The API key id (api_...), taken by the api-keys routes (example:
“api_eyVcnFJcR92BxBkz7N6g5w”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
scope: "project" or "team"The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The API key last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)
The member who created the key: a human, or the member id (apiu_...) of
the team API key that created it.
The date the API key was last used to authenticate a request, as an ISO string (example: “2023-02-03T11:19:41.579Z”). Absent if the key has never been used.
The key’s effective consumption (CU) cap for the period (per-key override, else the team-wide default). Absent when the key is uncapped.
For a PROJECT key: the project it was created on (the team id on some legacy keys). Absent for team keys.
Whether the project is privacyMode In a privacyMode project, users can only see their own generated assets (except admins)
users: array of object { id, createdAt, email, 5 more } The users of the project (get from the ProjectRoles table)
The users of the project (get from the ProjectRoles table)
The user email (example: “herve@scenario.com”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
High-level markdown description of the project Only returned on single project GET, not on list
ISO string date when the description was last updated Only returned on single project GET, not on list
When true, IP detection is switched off for this project even if the team has an active posture. Absent means the team posture applies. The posture itself (disabled / active-fail-open / active-fail-closed) is a team-level setting, see the team’s ipDetectionEnforcement.
The project’s consumption (CU) cap for the period. Absent when uncapped.
MemberUpdateResponse object { project }
project: object { id, createdAt, keys, 13 more }
keys: array of object { id, apiKeyId, apiKeyStatus, 11 more } The keys of the project (get from the ProjectRoles table)
The keys of the project (get from the ProjectRoles table)
The key’s member id (its API user id, apiu_...), taken by the member and
usage routes (example: “apiu_eyVcnFJcR92BxBkz7N6g5w”)
The API key id (api_...), taken by the api-keys routes (example:
“api_eyVcnFJcR92BxBkz7N6g5w”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
scope: "project" or "team"The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The scope of the API key: ‘project’ for project-scoped keys, ‘team’ for team-scoped keys
The API key last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)
The member who created the key: a human, or the member id (apiu_...) of
the team API key that created it.
The date the API key was last used to authenticate a request, as an ISO string (example: “2023-02-03T11:19:41.579Z”). Absent if the key has never been used.
The key’s effective consumption (CU) cap for the period (per-key override, else the team-wide default). Absent when the key is uncapped.
For a PROJECT key: the project it was created on (the team id on some legacy keys). Absent for team keys.
Whether the project is privacyMode In a privacyMode project, users can only see their own generated assets (except admins)
users: array of object { id, createdAt, email, 5 more } The users of the project (get from the ProjectRoles table)
The users of the project (get from the ProjectRoles table)
The user email (example: “herve@scenario.com”)
A project role value. Accepted values are:
- a built-in role:
"admin","editor"or"reader"(seeProjectRoles); - a custom inline role: a
;-separated scope list, e.g."assets.write;workflows.run".
Resolved to capabilities by ProjectRole.scopesFromRole().
High-level markdown description of the project Only returned on single project GET, not on list
ISO string date when the description was last updated Only returned on single project GET, not on list
When true, IP detection is switched off for this project even if the team has an active posture. Absent means the team posture applies. The posture itself (disabled / active-fail-open / active-fail-closed) is a team-level setting, see the team’s ipDetectionEnforcement.
The project’s consumption (CU) cap for the period. Absent when uncapped.
ProjectsMemory
ProjectsWatermark
Delete
Delete Logo
Preview
Retrieve
Update
Update Logo
ModelsExpand Collapse
WatermarkDeleteLogoResponse object { watermark }
watermark: object { id, createdAt, createdBy, 14 more } Forced-watermark configuration stored at one scope.
Forced-watermark configuration stored at one scope.
Whether the watermark is enforced on assets generated in this scope. A disabled project configuration falls back to its team’s.
Gap between repetitions, as a fraction of the mark’s own size. Tiled placement only; 0 repeats the mark edge to edge.
WatermarkRetrieveResponse object { watermark }
watermark: object { id, createdAt, createdBy, 14 more } Forced-watermark configuration stored at one scope.
Forced-watermark configuration stored at one scope.
Whether the watermark is enforced on assets generated in this scope. A disabled project configuration falls back to its team’s.
Gap between repetitions, as a fraction of the mark’s own size. Tiled placement only; 0 repeats the mark edge to edge.
WatermarkUpdateResponse object { watermark }
watermark: object { id, createdAt, createdBy, 14 more } Forced-watermark configuration stored at one scope.
Forced-watermark configuration stored at one scope.
Whether the watermark is enforced on assets generated in this scope. A disabled project configuration falls back to its team’s.
Gap between repetitions, as a fraction of the mark’s own size. Tiled placement only; 0 repeats the mark edge to edge.
WatermarkUpdateLogoResponse object { watermark }
watermark: object { id, createdAt, createdBy, 14 more } Forced-watermark configuration stored at one scope.
Forced-watermark configuration stored at one scope.
Whether the watermark is enforced on assets generated in this scope. A disabled project configuration falls back to its team’s.
Gap between repetitions, as a fraction of the mark’s own size. Tiled placement only; 0 repeats the mark edge to edge.
ProjectsWebhook Endpoints
Create
Delete
List
Update
ModelsExpand Collapse
WebhookEndpointCreateResponse object { webhookEndpoint }
webhookEndpoint: object { id, createdAt, enabled, 9 more } The creation response, and the only one that carries the secret: it is
generated once and never returned again, so a client that loses it has to
recreate the endpoint.
The creation response, and the only one that carries the secret: it is generated once and never returned again, so a client that loses it has to recreate the endpoint.
enabledEvents: array of "*" or "asset.download.completed" or "asset.download.created" or 16 moreThe events that trigger the webhook. [’*’] indicates that all events are enabled
The events that trigger the webhook. [’*’] indicates that all events are enabled
The ID of the owner of the webhook endpoint: a project id for job lifecycle events, a team id for alert events
WebhookEndpointListResponse object { webhookEndpoints }
webhookEndpoints: array of object { id, createdAt, enabled, 8 more } A list of the project webhooks
A list of the project webhooks
enabledEvents: array of "*" or "asset.download.completed" or "asset.download.created" or 16 moreThe events that trigger the webhook. [’*’] indicates that all events are enabled
The events that trigger the webhook. [’*’] indicates that all events are enabled
The ID of the owner of the webhook endpoint: a project id for job lifecycle events, a team id for alert events
WebhookEndpointUpdateResponse object { webhookEndpoint }
webhookEndpoint: object { id, createdAt, enabled, 8 more }
enabledEvents: array of "*" or "asset.download.completed" or "asset.download.created" or 16 moreThe events that trigger the webhook. [’*’] indicates that all events are enabled
The events that trigger the webhook. [’*’] indicates that all events are enabled
The ID of the owner of the webhook endpoint: a project id for job lifecycle events, a team id for alert events
ProjectsWebhook EndpointsEvents
List
Retrieve
ModelsExpand Collapse
EventListResponse object { items, nextPaginationToken }
items: array of object { id, endpointId, status, 2 more } A list of the project webhook events
A list of the project webhook events