> For the complete documentation index, see [llms.txt](https://argos-ci.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://argos-ci.com/docs/api-reference/reference/projects.md).

# Projects

Retrieve project metadata, either by slug or for the project tied to the current token.

## List an account's projects

> List the projects of an account that are visible to the authenticated user, most recently active first. Results are paginated. The token must be scoped to the account.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"personalAccessToken":[]},{"oauth2":["projects:read"]}],"components":{"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"PageInfo":{"type":"object","properties":{"total":{"type":"number","description":"Total number of items"},"page":{"type":"number","description":"Current page number"},"perPage":{"type":"number","description":"Number of items per page"}},"required":["total","page","perPage"],"additionalProperties":false,"description":"Page information"},"Project":{"type":"object","properties":{"id":{"type":"string"},"account":{"$ref":"#/components/schemas/Account"},"name":{"type":"string","minLength":1},"defaultBaseBranch":{"type":"string"},"hasRemoteContentAccess":{"type":"boolean"},"autoApprovedBranchGlob":{"type":"string","description":"Glob matching the branches whose builds are approved automatically."},"deploymentProductionBranchGlob":{"type":"string","description":"Glob matching the branches whose deployments are treated as production."},"private":{"type":"boolean","description":"Whether the project is private. Resolved from the linked repository unless overridden."},"summaryCheck":{"$ref":"#/components/schemas/SummaryCheck"},"prCommentEnabled":{"type":"boolean","description":"Whether Argos comments on pull requests."},"githubActionsOidcEnabled":{"type":"boolean","description":"Whether builds can authenticate with a GitHub Actions OIDC token instead of a project token."},"tokenlessAuthEnabled":{"type":"boolean","description":"Whether builds from forked pull requests can be uploaded without a token."},"deploymentEnabled":{"type":"boolean","description":"Whether deployments are served for this project."},"deploymentAuth":{"$ref":"#/components/schemas/DeploymentAuth"},"defaultUserLevel":{"anyOf":[{"$ref":"#/components/schemas/ProjectUserLevel"},{"type":"null"}]},"ignoreConfig":{"$ref":"#/components/schemas/IgnoreConfigOutput"}},"required":["id","account","name","defaultBaseBranch","hasRemoteContentAccess","autoApprovedBranchGlob","deploymentProductionBranchGlob","private","summaryCheck","prCommentEnabled","githubActionsOidcEnabled","tokenlessAuthEnabled","deploymentEnabled","deploymentAuth","defaultUserLevel","ignoreConfig"],"additionalProperties":false,"description":"Project"},"Account":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","minLength":1}},"required":["id","slug"],"additionalProperties":false,"description":"Account"},"SummaryCheck":{"type":"string","enum":["always","never","auto"],"description":"When to post the summary check on a pull request: `always`, `never`, or `auto` (only once the project has a baseline)."},"DeploymentAuth":{"type":"string","enum":["public","domain-private","private"],"description":"Who can reach the project's deployments: anyone (`public`), anyone with the domain (`domain-private`), or team members only (`private`, teams only)."},"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"IgnoreConfigOutput":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether changes can be ignored on this project."},"autoIgnore":{"anyOf":[{"type":"object","properties":{"changes":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of times a change must reappear before it is ignored automatically."}},"required":["changes"],"additionalProperties":false},{"type":"null"}],"description":"Auto-ignore settings, `null` when auto-ignore is off."}},"required":["enabled","autoIgnore"],"additionalProperties":false,"description":"How flaky changes are ignored on a project."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/accounts/{accountSlug}/projects":{"get":{"operationId":"listProjects","summary":"List an account's projects","description":"List the projects of an account that are visible to the authenticated user, most recently active first. Results are paginated. The token must be scoped to the account.","tags":["Projects"],"parameters":[{"in":"path","name":"accountSlug","schema":{"type":"string","minLength":1,"description":"Slug of the account to list projects for."},"required":true,"description":"Slug of the account to list projects for."},{"in":"query","name":"perPage","schema":{"description":"Number of items per page (max 100)","type":"string"},"description":"Number of items per page (max 100)"},{"in":"query","name":"page","schema":{"description":"Page number","type":"string"},"description":"Page number"}],"responses":{"200":{"description":"List of projects","content":{"application/json":{"schema":{"type":"object","properties":{"pageInfo":{"$ref":"#/components/schemas/PageInfo"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}},"required":["pageInfo","results"],"additionalProperties":false}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Get the current project

> Retrieve the project associated with the project token used to authenticate the request.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"projectToken":[]}],"components":{"securitySchemes":{"projectToken":{"type":"http","scheme":"bearer","bearerFormat":"Project Token","description":"Authenticate as a **project** with a project token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <project-token>\n```\n\nYou can find your project token in your Argos project settings.\nProject tokens are used by CI and the SDK to create builds and\ndeployments."}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"account":{"$ref":"#/components/schemas/Account"},"name":{"type":"string","minLength":1},"defaultBaseBranch":{"type":"string"},"hasRemoteContentAccess":{"type":"boolean"},"autoApprovedBranchGlob":{"type":"string","description":"Glob matching the branches whose builds are approved automatically."},"deploymentProductionBranchGlob":{"type":"string","description":"Glob matching the branches whose deployments are treated as production."},"private":{"type":"boolean","description":"Whether the project is private. Resolved from the linked repository unless overridden."},"summaryCheck":{"$ref":"#/components/schemas/SummaryCheck"},"prCommentEnabled":{"type":"boolean","description":"Whether Argos comments on pull requests."},"githubActionsOidcEnabled":{"type":"boolean","description":"Whether builds can authenticate with a GitHub Actions OIDC token instead of a project token."},"tokenlessAuthEnabled":{"type":"boolean","description":"Whether builds from forked pull requests can be uploaded without a token."},"deploymentEnabled":{"type":"boolean","description":"Whether deployments are served for this project."},"deploymentAuth":{"$ref":"#/components/schemas/DeploymentAuth"},"defaultUserLevel":{"anyOf":[{"$ref":"#/components/schemas/ProjectUserLevel"},{"type":"null"}]},"ignoreConfig":{"$ref":"#/components/schemas/IgnoreConfigOutput"}},"required":["id","account","name","defaultBaseBranch","hasRemoteContentAccess","autoApprovedBranchGlob","deploymentProductionBranchGlob","private","summaryCheck","prCommentEnabled","githubActionsOidcEnabled","tokenlessAuthEnabled","deploymentEnabled","deploymentAuth","defaultUserLevel","ignoreConfig"],"additionalProperties":false,"description":"Project"},"Account":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","minLength":1}},"required":["id","slug"],"additionalProperties":false,"description":"Account"},"SummaryCheck":{"type":"string","enum":["always","never","auto"],"description":"When to post the summary check on a pull request: `always`, `never`, or `auto` (only once the project has a baseline)."},"DeploymentAuth":{"type":"string","enum":["public","domain-private","private"],"description":"Who can reach the project's deployments: anyone (`public`), anyone with the domain (`domain-private`), or team members only (`private`, teams only)."},"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"IgnoreConfigOutput":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether changes can be ignored on this project."},"autoIgnore":{"anyOf":[{"type":"object","properties":{"changes":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of times a change must reappear before it is ignored automatically."}},"required":["changes"],"additionalProperties":false},{"type":"null"}],"description":"Auto-ignore settings, `null` when auto-ignore is off."}},"required":["enabled","autoIgnore"],"additionalProperties":false,"description":"How flaky changes are ignored on a project."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/project":{"get":{"operationId":"getAuthProject","summary":"Get the current project","description":"Retrieve the project associated with the project token used to authenticate the request.","tags":["Projects"],"responses":{"200":{"description":"Project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Create a project

> Create a new project in an account you administer. The authenticated personal access token must be scoped to the target account, and the acting user must be an administrator of it.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"personalAccessToken":[]},{"oauth2":["projects:write"]}],"components":{"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"account":{"$ref":"#/components/schemas/Account"},"name":{"type":"string","minLength":1},"defaultBaseBranch":{"type":"string"},"hasRemoteContentAccess":{"type":"boolean"},"autoApprovedBranchGlob":{"type":"string","description":"Glob matching the branches whose builds are approved automatically."},"deploymentProductionBranchGlob":{"type":"string","description":"Glob matching the branches whose deployments are treated as production."},"private":{"type":"boolean","description":"Whether the project is private. Resolved from the linked repository unless overridden."},"summaryCheck":{"$ref":"#/components/schemas/SummaryCheck"},"prCommentEnabled":{"type":"boolean","description":"Whether Argos comments on pull requests."},"githubActionsOidcEnabled":{"type":"boolean","description":"Whether builds can authenticate with a GitHub Actions OIDC token instead of a project token."},"tokenlessAuthEnabled":{"type":"boolean","description":"Whether builds from forked pull requests can be uploaded without a token."},"deploymentEnabled":{"type":"boolean","description":"Whether deployments are served for this project."},"deploymentAuth":{"$ref":"#/components/schemas/DeploymentAuth"},"defaultUserLevel":{"anyOf":[{"$ref":"#/components/schemas/ProjectUserLevel"},{"type":"null"}]},"ignoreConfig":{"$ref":"#/components/schemas/IgnoreConfigOutput"}},"required":["id","account","name","defaultBaseBranch","hasRemoteContentAccess","autoApprovedBranchGlob","deploymentProductionBranchGlob","private","summaryCheck","prCommentEnabled","githubActionsOidcEnabled","tokenlessAuthEnabled","deploymentEnabled","deploymentAuth","defaultUserLevel","ignoreConfig"],"additionalProperties":false,"description":"Project"},"Account":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","minLength":1}},"required":["id","slug"],"additionalProperties":false,"description":"Account"},"SummaryCheck":{"type":"string","enum":["always","never","auto"],"description":"When to post the summary check on a pull request: `always`, `never`, or `auto` (only once the project has a baseline)."},"DeploymentAuth":{"type":"string","enum":["public","domain-private","private"],"description":"Who can reach the project's deployments: anyone (`public`), anyone with the domain (`domain-private`), or team members only (`private`, teams only)."},"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"IgnoreConfigOutput":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether changes can be ignored on this project."},"autoIgnore":{"anyOf":[{"type":"object","properties":{"changes":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of times a change must reappear before it is ignored automatically."}},"required":["changes"],"additionalProperties":false},{"type":"null"}],"description":"Auto-ignore settings, `null` when auto-ignore is off."}},"required":["enabled","autoIgnore"],"additionalProperties":false,"description":"How flaky changes are ignored on a project."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/projects":{"post":{"operationId":"createProject","summary":"Create a project","description":"Create a new project in an account you administer. The authenticated personal access token must be scoped to the target account, and the acting user must be an administrator of it.","tags":["Projects"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-zA-Z0-9_\\-.]+$","description":"Name of the project to create. Must be unique within the account (case-insensitive) and cannot be a reserved name."},"accountSlug":{"type":"string","minLength":1,"description":"Slug of the account (personal or team) that will own the project. The personal access token must be scoped to this account and the acting user must be one of its administrators."}},"required":["name","accountSlug"]}}}},"responses":{"201":{"description":"Project created successfully — returns the project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Get a project

> Retrieve a project by its owner (account slug) and project name.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"projectToken":[]},{"personalAccessToken":[]},{"oauth2":["projects:read"]}],"components":{"securitySchemes":{"projectToken":{"type":"http","scheme":"bearer","bearerFormat":"Project Token","description":"Authenticate as a **project** with a project token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <project-token>\n```\n\nYou can find your project token in your Argos project settings.\nProject tokens are used by CI and the SDK to create builds and\ndeployments."},"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"account":{"$ref":"#/components/schemas/Account"},"name":{"type":"string","minLength":1},"defaultBaseBranch":{"type":"string"},"hasRemoteContentAccess":{"type":"boolean"},"autoApprovedBranchGlob":{"type":"string","description":"Glob matching the branches whose builds are approved automatically."},"deploymentProductionBranchGlob":{"type":"string","description":"Glob matching the branches whose deployments are treated as production."},"private":{"type":"boolean","description":"Whether the project is private. Resolved from the linked repository unless overridden."},"summaryCheck":{"$ref":"#/components/schemas/SummaryCheck"},"prCommentEnabled":{"type":"boolean","description":"Whether Argos comments on pull requests."},"githubActionsOidcEnabled":{"type":"boolean","description":"Whether builds can authenticate with a GitHub Actions OIDC token instead of a project token."},"tokenlessAuthEnabled":{"type":"boolean","description":"Whether builds from forked pull requests can be uploaded without a token."},"deploymentEnabled":{"type":"boolean","description":"Whether deployments are served for this project."},"deploymentAuth":{"$ref":"#/components/schemas/DeploymentAuth"},"defaultUserLevel":{"anyOf":[{"$ref":"#/components/schemas/ProjectUserLevel"},{"type":"null"}]},"ignoreConfig":{"$ref":"#/components/schemas/IgnoreConfigOutput"}},"required":["id","account","name","defaultBaseBranch","hasRemoteContentAccess","autoApprovedBranchGlob","deploymentProductionBranchGlob","private","summaryCheck","prCommentEnabled","githubActionsOidcEnabled","tokenlessAuthEnabled","deploymentEnabled","deploymentAuth","defaultUserLevel","ignoreConfig"],"additionalProperties":false,"description":"Project"},"Account":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","minLength":1}},"required":["id","slug"],"additionalProperties":false,"description":"Account"},"SummaryCheck":{"type":"string","enum":["always","never","auto"],"description":"When to post the summary check on a pull request: `always`, `never`, or `auto` (only once the project has a baseline)."},"DeploymentAuth":{"type":"string","enum":["public","domain-private","private"],"description":"Who can reach the project's deployments: anyone (`public`), anyone with the domain (`domain-private`), or team members only (`private`, teams only)."},"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"IgnoreConfigOutput":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether changes can be ignored on this project."},"autoIgnore":{"anyOf":[{"type":"object","properties":{"changes":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of times a change must reappear before it is ignored automatically."}},"required":["changes"],"additionalProperties":false},{"type":"null"}],"description":"Auto-ignore settings, `null` when auto-ignore is off."}},"required":["enabled","autoIgnore"],"additionalProperties":false,"description":"How flaky changes are ignored on a project."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/projects/{owner}/{project}":{"get":{"operationId":"getProject","summary":"Get a project","description":"Retrieve a project by its owner (account slug) and project name.","tags":["Projects"],"parameters":[{"in":"path","name":"owner","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"project","schema":{"type":"string","minLength":1},"required":true}],"responses":{"200":{"description":"Project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Update a project

> Update a project's settings. Only the fields present in the request are changed. Requires administrator access to the project.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"personalAccessToken":[]},{"oauth2":["projects:write"]}],"components":{"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"SummaryCheck":{"type":"string","enum":["always","never","auto"],"description":"When to post the summary check on a pull request: `always`, `never`, or `auto` (only once the project has a baseline)."},"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"IgnoreConfig":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether changes can be ignored on this project."},"autoIgnore":{"anyOf":[{"type":"object","properties":{"changes":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of times a change must reappear before it is ignored automatically."}},"required":["changes"]},{"type":"null"}],"description":"Auto-ignore settings, `null` when auto-ignore is off."}},"required":["enabled","autoIgnore"],"description":"How flaky changes are ignored on a project."},"DeploymentAuth":{"type":"string","enum":["public","domain-private","private"],"description":"Who can reach the project's deployments: anyone (`public`), anyone with the domain (`domain-private`), or team members only (`private`, teams only)."},"Project":{"type":"object","properties":{"id":{"type":"string"},"account":{"$ref":"#/components/schemas/Account"},"name":{"type":"string","minLength":1},"defaultBaseBranch":{"type":"string"},"hasRemoteContentAccess":{"type":"boolean"},"autoApprovedBranchGlob":{"type":"string","description":"Glob matching the branches whose builds are approved automatically."},"deploymentProductionBranchGlob":{"type":"string","description":"Glob matching the branches whose deployments are treated as production."},"private":{"type":"boolean","description":"Whether the project is private. Resolved from the linked repository unless overridden."},"summaryCheck":{"$ref":"#/components/schemas/SummaryCheck"},"prCommentEnabled":{"type":"boolean","description":"Whether Argos comments on pull requests."},"githubActionsOidcEnabled":{"type":"boolean","description":"Whether builds can authenticate with a GitHub Actions OIDC token instead of a project token."},"tokenlessAuthEnabled":{"type":"boolean","description":"Whether builds from forked pull requests can be uploaded without a token."},"deploymentEnabled":{"type":"boolean","description":"Whether deployments are served for this project."},"deploymentAuth":{"$ref":"#/components/schemas/DeploymentAuth"},"defaultUserLevel":{"anyOf":[{"$ref":"#/components/schemas/ProjectUserLevel"},{"type":"null"}]},"ignoreConfig":{"$ref":"#/components/schemas/IgnoreConfigOutput"}},"required":["id","account","name","defaultBaseBranch","hasRemoteContentAccess","autoApprovedBranchGlob","deploymentProductionBranchGlob","private","summaryCheck","prCommentEnabled","githubActionsOidcEnabled","tokenlessAuthEnabled","deploymentEnabled","deploymentAuth","defaultUserLevel","ignoreConfig"],"additionalProperties":false,"description":"Project"},"Account":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","minLength":1}},"required":["id","slug"],"additionalProperties":false,"description":"Account"},"IgnoreConfigOutput":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether changes can be ignored on this project."},"autoIgnore":{"anyOf":[{"type":"object","properties":{"changes":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of times a change must reappear before it is ignored automatically."}},"required":["changes"],"additionalProperties":false},{"type":"null"}],"description":"Auto-ignore settings, `null` when auto-ignore is off."}},"required":["enabled","autoIgnore"],"additionalProperties":false,"description":"How flaky changes are ignored on a project."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/projects/{owner}/{project}":{"patch":{"operationId":"updateProject","summary":"Update a project","description":"Update a project's settings. Only the fields present in the request are changed. Requires administrator access to the project.","tags":["Projects"],"parameters":[{"in":"path","name":"owner","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"project","schema":{"type":"string","minLength":1},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"New name for the project. Must be unique within the owning account (case-insensitive)."},"defaultBaseBranch":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Branch used as the baseline when no better one applies. `null` falls back to the repository's default branch."},"autoApprovedBranchGlob":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Glob matching the branches whose builds are approved automatically. `null` falls back to the default base branch."},"deploymentProductionBranchGlob":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Glob matching the branches whose deployments count as production. `null` falls back to the repository's default branch."},"private":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Force the project's privacy. `null` inherits it from the linked repository."},"summaryCheck":{"$ref":"#/components/schemas/SummaryCheck"},"defaultUserLevel":{"anyOf":[{"$ref":"#/components/schemas/ProjectUserLevel"},{"type":"null"}],"description":"Access given to team members that are not contributors on this project. `null` gives them none."},"ignoreConfig":{"$ref":"#/components/schemas/IgnoreConfig"},"deploymentEnabled":{"type":"boolean"},"deploymentAuth":{"$ref":"#/components/schemas/DeploymentAuth"},"githubActionsOidcEnabled":{"type":"boolean"},"tokenlessAuthEnabled":{"type":"boolean"}}}}}},"responses":{"200":{"description":"The updated project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## List a project's contributors

> List the users explicitly granted access to a project, with their level. Team owners and members are not listed — they reach every project through their team role. The authenticated user comes first when they are one of them.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"personalAccessToken":[]},{"oauth2":["projects:read"]}],"components":{"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"PageInfo":{"type":"object","properties":{"total":{"type":"number","description":"Total number of items"},"page":{"type":"number","description":"Current page number"},"perPage":{"type":"number","description":"Number of items per page"}},"required":["total","page","perPage"],"additionalProperties":false,"description":"Page information"},"ProjectContributor":{"type":"object","properties":{"id":{"type":"string","description":"Identifier of the grant, not of the user."},"user":{"$ref":"#/components/schemas/User"},"level":{"$ref":"#/components/schemas/ProjectUserLevel"}},"required":["id","user","level"],"additionalProperties":false,"description":"A contributor explicitly granted access to a project. Team owners and members reach every project without appearing here."},"User":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","slug","name"],"additionalProperties":false,"description":"A user."},"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/projects/{owner}/{project}/contributors":{"get":{"operationId":"listProjectContributors","summary":"List a project's contributors","description":"List the users explicitly granted access to a project, with their level. Team owners and members are not listed — they reach every project through their team role. The authenticated user comes first when they are one of them.","tags":["Projects"],"parameters":[{"in":"path","name":"owner","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"project","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"perPage","schema":{"description":"Number of items per page (max 100)","type":"string"},"description":"Number of items per page (max 100)"},{"in":"query","name":"page","schema":{"description":"Page number","type":"string"},"description":"Page number"}],"responses":{"200":{"description":"List of contributors","content":{"application/json":{"schema":{"type":"object","properties":{"pageInfo":{"$ref":"#/components/schemas/PageInfo"},"results":{"type":"array","items":{"$ref":"#/components/schemas/ProjectContributor"}}},"required":["pageInfo","results"],"additionalProperties":false}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Grant a contributor access to a project

> Grant a user access to a project, or change the level they already hold. Requires administrator access to the project. Only meaningful for team contributors: owners and members already reach every project.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"personalAccessToken":[]},{"oauth2":["projects:write"]}],"components":{"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"ProjectContributor":{"type":"object","properties":{"id":{"type":"string","description":"Identifier of the grant, not of the user."},"user":{"$ref":"#/components/schemas/User"},"level":{"$ref":"#/components/schemas/ProjectUserLevel"}},"required":["id","user","level"],"additionalProperties":false,"description":"A contributor explicitly granted access to a project. Team owners and members reach every project without appearing here."},"User":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","slug","name"],"additionalProperties":false,"description":"A user."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/projects/{owner}/{project}/contributors/{userId}":{"put":{"operationId":"setProjectContributor","summary":"Grant a contributor access to a project","description":"Grant a user access to a project, or change the level they already hold. Requires administrator access to the project. Only meaningful for team contributors: owners and members already reach every project.","tags":["Projects"],"parameters":[{"in":"path","name":"owner","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"project","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"userId","schema":{"type":"string","description":"Identifier of the user — the `user.id` returned by `listAccountMembers` or `listProjectContributors`."},"required":true,"description":"Identifier of the user — the `user.id` returned by `listAccountMembers` or `listProjectContributors`."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"level":{"$ref":"#/components/schemas/ProjectUserLevel"}},"required":["level"]}}}},"responses":{"200":{"description":"The granted access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectContributor"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Revoke a contributor's access

> Revoke a user's access to a project. Requires administrator access to the project, except when removing yourself — a contributor can always walk away from a project.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"personalAccessToken":[]},{"oauth2":["projects:write"]}],"components":{"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/projects/{owner}/{project}/contributors/{userId}":{"delete":{"operationId":"removeProjectContributor","summary":"Revoke a contributor's access","description":"Revoke a user's access to a project. Requires administrator access to the project, except when removing yourself — a contributor can always walk away from a project.","tags":["Projects"],"parameters":[{"in":"path","name":"owner","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"project","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"userId","schema":{"type":"string","description":"Identifier of the user — the `user.id` returned by `listAccountMembers` or `listProjectContributors`."},"required":true,"description":"Identifier of the user — the `user.id` returned by `listAccountMembers` or `listProjectContributors`."}],"responses":{"204":{"description":"Access revoked"},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Transfer a project

> Move a project to another account, optionally renaming it. The token must be scoped to both accounts, and the acting user must administer the project as well as the account receiving it.

````json
{"openapi":"3.2.0","info":{"title":"Argos API","version":"2.0.0"},"tags":[{"name":"Projects","description":"Retrieve project metadata, either by slug or for the project tied to the current token."}],"servers":[{"url":"https://api.argos-ci.com/v2","description":"API Endpoint"}],"security":[{"personalAccessToken":[]},{"oauth2":["projects:write"]}],"components":{"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Personal Access Token","description":"Authenticate as a **user** with a personal access token.\n\nSend it as a bearer token in the `Authorization` header:\n\n```http\nAuthorization: Bearer <personal-access-token>\n```\n\nPersonal access tokens act on behalf of the user that created them\nand are required by endpoints that perform user actions, such as\nreviewing builds and posting comments."},"oauth2":{"type":"oauth2","description":"Authenticate as a **user** via an OAuth 2.1 access token obtained\nthrough the authorization-code (+ PKCE) flow. Used by the CLI and by\nMCP clients/agents. The token acts on behalf of the authorizing user,\nlimited to the granted scopes and organizations.","flows":{"authorizationCode":{"authorizationUrl":"https://app.argos-ci.com/oauth/authorize","tokenUrl":"https://app.argos-ci.com/oauth/token","refreshUrl":"https://app.argos-ci.com/oauth/token","scopes":{"profile":"Read your Argos profile and the list of teams you belong to.","projects:read":"Read your projects, builds, screenshots, diffs, tests, and analytics.","projects:write":"Create and configure projects and their settings.","builds:write":"Create and upload builds and screenshots.","reviews:write":"Approve, reject, or dismiss build reviews and ignore changes.","comments:read":"Read build comments and threads.","comments:write":"Post, edit, and delete comments, add reactions, and manage subscriptions.","media:read":"Read the images and videos uploaded to your teams.","media:write":"Upload images and videos, and delete the ones already uploaded.","account:admin":"Manage organization settings and members."}}}}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"account":{"$ref":"#/components/schemas/Account"},"name":{"type":"string","minLength":1},"defaultBaseBranch":{"type":"string"},"hasRemoteContentAccess":{"type":"boolean"},"autoApprovedBranchGlob":{"type":"string","description":"Glob matching the branches whose builds are approved automatically."},"deploymentProductionBranchGlob":{"type":"string","description":"Glob matching the branches whose deployments are treated as production."},"private":{"type":"boolean","description":"Whether the project is private. Resolved from the linked repository unless overridden."},"summaryCheck":{"$ref":"#/components/schemas/SummaryCheck"},"prCommentEnabled":{"type":"boolean","description":"Whether Argos comments on pull requests."},"githubActionsOidcEnabled":{"type":"boolean","description":"Whether builds can authenticate with a GitHub Actions OIDC token instead of a project token."},"tokenlessAuthEnabled":{"type":"boolean","description":"Whether builds from forked pull requests can be uploaded without a token."},"deploymentEnabled":{"type":"boolean","description":"Whether deployments are served for this project."},"deploymentAuth":{"$ref":"#/components/schemas/DeploymentAuth"},"defaultUserLevel":{"anyOf":[{"$ref":"#/components/schemas/ProjectUserLevel"},{"type":"null"}]},"ignoreConfig":{"$ref":"#/components/schemas/IgnoreConfigOutput"}},"required":["id","account","name","defaultBaseBranch","hasRemoteContentAccess","autoApprovedBranchGlob","deploymentProductionBranchGlob","private","summaryCheck","prCommentEnabled","githubActionsOidcEnabled","tokenlessAuthEnabled","deploymentEnabled","deploymentAuth","defaultUserLevel","ignoreConfig"],"additionalProperties":false,"description":"Project"},"Account":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","minLength":1}},"required":["id","slug"],"additionalProperties":false,"description":"Account"},"SummaryCheck":{"type":"string","enum":["always","never","auto"],"description":"When to post the summary check on a pull request: `always`, `never`, or `auto` (only once the project has a baseline)."},"DeploymentAuth":{"type":"string","enum":["public","domain-private","private"],"description":"Who can reach the project's deployments: anyone (`public`), anyone with the domain (`domain-private`), or team members only (`private`, teams only)."},"ProjectUserLevel":{"type":"string","enum":["admin","reviewer","viewer"],"description":"Access level given to team members that are not explicit contributors on the project. `null` means they get no access."},"IgnoreConfigOutput":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether changes can be ignored on this project."},"autoIgnore":{"anyOf":[{"type":"object","properties":{"changes":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of times a change must reappear before it is ignored automatically."}},"required":["changes"],"additionalProperties":false},{"type":"null"}],"description":"Auto-ignore settings, `null` when auto-ignore is off."}},"required":["enabled","autoIgnore"],"additionalProperties":false,"description":"How flaky changes are ignored on a project."},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["error"],"additionalProperties":false,"description":"Error response"}}},"paths":{"/projects/{owner}/{project}/transfer":{"post":{"operationId":"transferProject","summary":"Transfer a project","description":"Move a project to another account, optionally renaming it. The token must be scoped to both accounts, and the acting user must administer the project as well as the account receiving it.","tags":["Projects"],"parameters":[{"in":"path","name":"owner","schema":{"type":"string","minLength":1},"required":true},{"in":"path","name":"project","schema":{"type":"string","minLength":1},"required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targetAccountSlug":{"type":"string","minLength":1,"description":"Slug of the account that will own the project."},"name":{"description":"Name to give the project on the target account. Defaults to its current name, which must be free there.","type":"string","minLength":1}},"required":["targetAccountSlug"]}}}},"responses":{"200":{"description":"The transferred project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://argos-ci.com/docs/api-reference/reference/projects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.