Factories

Get a factory by its UID.

get/factory/{uid}

Request

  • Base URL
    https://app.warp.dev/api/v1
  • Auth
    HTTP bearer

Path parameters

uidstring required

The public UID of the factory.

Response

Factory details

uidstring required

Public UID of the factory.

team_uidstring required

Public UID of the team that owns the factory.

namestring required

Display name of the factory.

descriptionstring nullable required

Optional description of the factory.

aliasstring nullable required

Optional display handle for the factory, unique across the team's Warp workspace when set.

avatar_urlstring nullable required

Short-lived signed URL for displaying the factory's avatar. The URL may change between reads.

code_forge'GITHUB' | 'GITLAB' | 'AZURE_DEVOPS' | 'NONE' required

Primary source-control provider for the factory. GITHUB and GITLAB identify the compatibility primary when repositories span one or more forges. AZURE_DEVOPS identifies Azure Repos. NONE declares a repo-less factory with no native repositories; its environment relies on setup_commands to clone from any host.

code_forgesFactoryCodeForge[] required

Enabled source-control providers for the factory. Empty when the factory has no enabled forge; never contains NONE.

default_environmentstring nullable required

Public UID of the factory's default environment. File-managed factories may omit this default.

default_modelstring nullable required

The default model ID for the factory's runs. File-managed factories may omit this default. Live-managed create and PATCH requests still capture a concrete validated model ID.

credential_strategy'CREATOR' | 'EXECUTOR' required

Default credential strategy for runs executed by the factory's named agents.

  • EXECUTOR (default): runs authenticate with the named agent's own credentials (e.g. a GitHub App installation token for the factory's team).
  • CREATOR: runs authenticate with the credentials of the principal that created the run.
restrict_followups_to_starterboolean

When true, only the Warp user who started a run may send it follow-ups. Senders on Slack, GitHub, Linear and other integrations are matched to Warp users through their linked accounts; follow-ups from agents and the system are unaffected.

allow_service_account_followupsboolean

When true, follow-ups sent with a service account's API key are accepted even though restrict_followups_to_starter is true. Has no effect while restrict_followups_to_starter is false.

created_atstring date-time required

Time the factory was created.

updated_atstring date-time required

Time the factory was last updated.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status