Get project details
GET
/api/v0/projects/{project_uuid}- Path parameters:
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid} \ -H "X-API-KEY: <your-api-key>" - Responses:
200OK
JSONCopied to clipboard{ "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "name": "string", "description": "string", "git_repository": "string", "allow_all_branching": true, "prevent_permissions_granted_on_branch": true, "main_git_branch": "string", "external_url": "string", "links": [ { "name": "string", "link": "string" } ], "provider": "string", "default_destroy_on_publish": true, "default_authentication": "string", "default_publish_mode": "string", "last_synced": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compiled_success": "2024-01-01T00:00:00Z", "auto_create_site_on_pr": true, "comment_on_pr": true, "pr_comment_skip_drafts": true, "pr_comment_footer": "string", "auto_create_skip_drafts": true, "pr_tab_visible": true, "publishing_tab_visible": true, "branches_tab_visible": true, "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "has_default_password": true, "organisation_uuid": "00000000-0000-0000-0000-000000000000", "main_site": { "site_name": "string", "subpath": "string", "stable_domain": "string", "ssg": "string", "last_synced": "2024-01-01T00:00:00Z", "last_output": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compressed": "2024-01-01T00:00:00Z", "last_internationalised": "2024-01-01T00:00:00Z", "last_published": "2024-01-01T00:00:00Z", "last_cleaned": "2024-01-01T00:00:00Z", "storage_provider": "string", "client_author_name": "string", "client_author_email": "string", "create_source": "string", "hosting_choice": "string", "building_locked": true, "editing_locked": true, "uploads_locked": true, "browsing_locked": true, "last_compiled_success": "2024-01-01T00:00:00Z", "preview_url": "string", "documentation_url": "string", "support_url": "string", "client_editor_route": "string", "active_quest": "string", "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "mode": "string", "project_id": 0, "project_uuid": "string", "pr_number": 0, "pr_external_url": "string", "cloudcannon_config_path": "string", "output_storage_provider": "string", "base_domain": { "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "base_domain": "string", "uses_dns": true, "auto_generate_ssl_failures": 0, "auto_generate_ssl_max_failures": 0, "next_ssl_generate_attempt_at": "2024-01-01T00:00:00Z", "ssl_generation_failing_email_sent_at": "2024-01-01T00:00:00Z", "in_cloudflare_beta": true, "cloudflare_dns_migrated": true, "cloudflare_zone_id": "string", "cloudflare_zone_create_error": "string", "cloudflare_zone_create_error_from_cloudflare": true, "mx_record": "string", "spf_record": "string", "minimum_tls_version": "string", "cloudflare_name_servers": [ "string" ], "name_servers": [ "string" ], "cloudflare_dns_migration": [ {} ], "a_record": [ {} ], "cname_record": [ {} ], "txt_record": [ {} ] } } }401Unauthorized
JSONCopied to clipboard{ "error": "string" }403Forbidden
JSONCopied to clipboard{ "error": "string" }
Update project details
PUT
/api/v0/projects/{project_uuid}- Path parameters:
- Request body:
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid} \ -X PUT \ -H "X-API-KEY: <your-api-key>" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "external_url": "string", "description": "string", "links": "string", "default_destroy_on_publish": true, "default_authentication": "string", "default_publish_mode": "string", "default_password": "string", "pr_tab_visible": true, "publishing_tab_visible": true, "branches_tab_visible": true }' - Responses:
200OK
JSONCopied to clipboard{ "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "name": "string", "description": "string", "git_repository": "string", "allow_all_branching": true, "prevent_permissions_granted_on_branch": true, "main_git_branch": "string", "external_url": "string", "links": [ { "name": "string", "link": "string" } ], "provider": "string", "default_destroy_on_publish": true, "default_authentication": "string", "default_publish_mode": "string", "last_synced": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compiled_success": "2024-01-01T00:00:00Z", "auto_create_site_on_pr": true, "comment_on_pr": true, "pr_comment_skip_drafts": true, "pr_comment_footer": "string", "auto_create_skip_drafts": true, "pr_tab_visible": true, "publishing_tab_visible": true, "branches_tab_visible": true, "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "has_default_password": true, "organisation_uuid": "00000000-0000-0000-0000-000000000000", "main_site": { "site_name": "string", "subpath": "string", "stable_domain": "string", "ssg": "string", "last_synced": "2024-01-01T00:00:00Z", "last_output": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compressed": "2024-01-01T00:00:00Z", "last_internationalised": "2024-01-01T00:00:00Z", "last_published": "2024-01-01T00:00:00Z", "last_cleaned": "2024-01-01T00:00:00Z", "storage_provider": "string", "client_author_name": "string", "client_author_email": "string", "create_source": "string", "hosting_choice": "string", "building_locked": true, "editing_locked": true, "uploads_locked": true, "browsing_locked": true, "last_compiled_success": "2024-01-01T00:00:00Z", "preview_url": "string", "documentation_url": "string", "support_url": "string", "client_editor_route": "string", "active_quest": "string", "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "mode": "string", "project_id": 0, "project_uuid": "string", "pr_number": 0, "pr_external_url": "string", "cloudcannon_config_path": "string", "output_storage_provider": "string", "base_domain": { "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "base_domain": "string", "uses_dns": true, "auto_generate_ssl_failures": 0, "auto_generate_ssl_max_failures": 0, "next_ssl_generate_attempt_at": "2024-01-01T00:00:00Z", "ssl_generation_failing_email_sent_at": "2024-01-01T00:00:00Z", "in_cloudflare_beta": true, "cloudflare_dns_migrated": true, "cloudflare_zone_id": "string", "cloudflare_zone_create_error": "string", "cloudflare_zone_create_error_from_cloudflare": true, "mx_record": "string", "spf_record": "string", "minimum_tls_version": "string", "cloudflare_name_servers": [ "string" ], "name_servers": [ "string" ], "cloudflare_dns_migration": [ {} ], "a_record": [ {} ], "cname_record": [ {} ], "txt_record": [ {} ] } } }401Unauthorized
JSONCopied to clipboard{ "error": "string" }403Forbidden
JSONCopied to clipboard{ "error": "string" }422Unprocessable
JSONCopied to clipboard{ "errors": {} }
Delete project
DELETE
/api/v0/projects/{project_uuid}- Path parameters:
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid} \ -X DELETE \ -H "X-API-KEY: <your-api-key>" - Responses:
204Deleted
401Unauthorized
JSONCopied to clipboard{ "error": "string" }403Forbidden
JSONCopied to clipboard{ "error": "string" }
List branches for the project repository
GET
/api/v0/projects/{project_uuid}/branches- Path parameters:
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid}/branches \ -H "X-API-KEY: <your-api-key>" - Responses:
200OK
JSONCopied to clipboard[ { "name": "string", "sha": "string", "updated_at": "2024-01-01T00:00:00Z", "sites": [ { "uuid": "string", "site_name": "string", "stable_domain": "string" } ], "is_default": true, "pull_request": { "number": 0, "title": "string", "external_url": "string", "state": "string", "updated_at": "2024-01-01T00:00:00Z" } } ]401Unauthorized
JSONCopied to clipboard{ "error": "string" }402FeatureNotOnPlan
JSONCopied to clipboard{ "errors": {} }403Forbidden
JSONCopied to clipboard{ "error": "string" }404Not Found
JSONCopied to clipboard{ "error": "string" }422Unprocessable
JSONCopied to clipboard{ "errors": {} }
Update project Git details
PUT
/api/v0/projects/{project_uuid}/git- Path parameters:
- Request body:
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid}/git \ -X PUT \ -H "X-API-KEY: <your-api-key>" \ -H "Content-Type: application/json" \ -d '{ "git_repository": "string", "allow_all_branching": true, "prevent_permissions_granted_on_branch": true, "main_git_branch": "string", "provider": "string" }' - Responses:
200OK
JSONCopied to clipboard{ "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "name": "string", "description": "string", "git_repository": "string", "allow_all_branching": true, "prevent_permissions_granted_on_branch": true, "main_git_branch": "string", "external_url": "string", "links": [ { "name": "string", "link": "string" } ], "provider": "string", "default_destroy_on_publish": true, "default_authentication": "string", "default_publish_mode": "string", "last_synced": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compiled_success": "2024-01-01T00:00:00Z", "auto_create_site_on_pr": true, "comment_on_pr": true, "pr_comment_skip_drafts": true, "pr_comment_footer": "string", "auto_create_skip_drafts": true, "pr_tab_visible": true, "publishing_tab_visible": true, "branches_tab_visible": true, "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "has_default_password": true, "organisation_uuid": "00000000-0000-0000-0000-000000000000", "main_site": { "site_name": "string", "subpath": "string", "stable_domain": "string", "ssg": "string", "last_synced": "2024-01-01T00:00:00Z", "last_output": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compressed": "2024-01-01T00:00:00Z", "last_internationalised": "2024-01-01T00:00:00Z", "last_published": "2024-01-01T00:00:00Z", "last_cleaned": "2024-01-01T00:00:00Z", "storage_provider": "string", "client_author_name": "string", "client_author_email": "string", "create_source": "string", "hosting_choice": "string", "building_locked": true, "editing_locked": true, "uploads_locked": true, "browsing_locked": true, "last_compiled_success": "2024-01-01T00:00:00Z", "preview_url": "string", "documentation_url": "string", "support_url": "string", "client_editor_route": "string", "active_quest": "string", "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "mode": "string", "project_id": 0, "project_uuid": "string", "pr_number": 0, "pr_external_url": "string", "cloudcannon_config_path": "string", "output_storage_provider": "string", "base_domain": { "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "base_domain": "string", "uses_dns": true, "auto_generate_ssl_failures": 0, "auto_generate_ssl_max_failures": 0, "next_ssl_generate_attempt_at": "2024-01-01T00:00:00Z", "ssl_generation_failing_email_sent_at": "2024-01-01T00:00:00Z", "in_cloudflare_beta": true, "cloudflare_dns_migrated": true, "cloudflare_zone_id": "string", "cloudflare_zone_create_error": "string", "cloudflare_zone_create_error_from_cloudflare": true, "mx_record": "string", "spf_record": "string", "minimum_tls_version": "string", "cloudflare_name_servers": [ "string" ], "name_servers": [ "string" ], "cloudflare_dns_migration": [ {} ], "a_record": [ {} ], "cname_record": [ {} ], "txt_record": [ {} ] } } }401Unauthorized
JSONCopied to clipboard{ "error": "string" }403Forbidden
JSONCopied to clipboard{ "error": "string" }422Unprocessable
JSONCopied to clipboard{ "errors": {} }
List open pull requests for the project repository
GET
/api/v0/projects/{project_uuid}/pull-requests- Path parameters:
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid}/pull-requests \ -H "X-API-KEY: <your-api-key>" - Responses:
200OK
JSONCopied to clipboard[ { "number": 0, "state": "string", "title": "string", "body": "string", "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "closed_at": "2024-01-01T00:00:00Z", "merged_at": "2024-01-01T00:00:00Z", "locked": true, "draft": true, "head": { "ref": "string", "sha": "string", "repo": { "name": "string", "full_name": "string" } }, "base": { "ref": "string", "sha": "string", "repo": { "name": "string", "full_name": "string" } }, "is_external_contributor": true, "sites": [ { "uuid": "string", "site_name": "string", "stable_domain": "string" } ] } ]401Unauthorized
JSONCopied to clipboard{ "error": "string" }402FeatureNotOnPlan
JSONCopied to clipboard{ "errors": {} }403Forbidden
JSONCopied to clipboard{ "error": "string" }404Not Found
JSONCopied to clipboard{ "error": "string" }422Unprocessable
JSONCopied to clipboard{ "errors": {} }
Refresh deploy-preview PR comments for every site on this project
POST
/api/v0/projects/{project_uuid}/refresh-pr-comments- Path parameters:
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid}/refresh-pr-comments \ -X POST \ -H "X-API-KEY: <your-api-key>" - Responses:
200OK
JSONCopied to clipboard{ "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "name": "string", "description": "string", "git_repository": "string", "allow_all_branching": true, "prevent_permissions_granted_on_branch": true, "main_git_branch": "string", "external_url": "string", "links": [ { "name": "string", "link": "string" } ], "provider": "string", "default_destroy_on_publish": true, "default_authentication": "string", "default_publish_mode": "string", "last_synced": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compiled_success": "2024-01-01T00:00:00Z", "auto_create_site_on_pr": true, "comment_on_pr": true, "pr_comment_skip_drafts": true, "pr_comment_footer": "string", "auto_create_skip_drafts": true, "pr_tab_visible": true, "publishing_tab_visible": true, "branches_tab_visible": true, "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "has_default_password": true, "organisation_uuid": "00000000-0000-0000-0000-000000000000", "main_site": { "site_name": "string", "subpath": "string", "stable_domain": "string", "ssg": "string", "last_synced": "2024-01-01T00:00:00Z", "last_output": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compressed": "2024-01-01T00:00:00Z", "last_internationalised": "2024-01-01T00:00:00Z", "last_published": "2024-01-01T00:00:00Z", "last_cleaned": "2024-01-01T00:00:00Z", "storage_provider": "string", "client_author_name": "string", "client_author_email": "string", "create_source": "string", "hosting_choice": "string", "building_locked": true, "editing_locked": true, "uploads_locked": true, "browsing_locked": true, "last_compiled_success": "2024-01-01T00:00:00Z", "preview_url": "string", "documentation_url": "string", "support_url": "string", "client_editor_route": "string", "active_quest": "string", "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "mode": "string", "project_id": 0, "project_uuid": "string", "pr_number": 0, "pr_external_url": "string", "cloudcannon_config_path": "string", "output_storage_provider": "string", "base_domain": { "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "base_domain": "string", "uses_dns": true, "auto_generate_ssl_failures": 0, "auto_generate_ssl_max_failures": 0, "next_ssl_generate_attempt_at": "2024-01-01T00:00:00Z", "ssl_generation_failing_email_sent_at": "2024-01-01T00:00:00Z", "in_cloudflare_beta": true, "cloudflare_dns_migrated": true, "cloudflare_zone_id": "string", "cloudflare_zone_create_error": "string", "cloudflare_zone_create_error_from_cloudflare": true, "mx_record": "string", "spf_record": "string", "minimum_tls_version": "string", "cloudflare_name_servers": [ "string" ], "name_servers": [ "string" ], "cloudflare_dns_migration": [ {} ], "a_record": [ {} ], "cname_record": [ {} ], "txt_record": [ {} ] } } }401Unauthorized
JSONCopied to clipboard{ "error": "string" }403Forbidden
JSONCopied to clipboard{ "error": "string" }
Get sites from projects
GET
/api/v0/projects/{project_uuid}/sites- Path parameters:
- Filters:
- Sorting:
Attribute to sort the results by
Defaults to:
"id"Allowed values:
iduuidsite_namedomain_namecreated_atupdated_atlast_syncedlast_compressedlast_compiledlast_cleanedpriority_domain_atstorage_providerstable_domainsubpathsync_errorDirection to sort the results
Defaults to:
"ASC"Allowed values:
ASCDESC- Pagination:
Page number to fetch (1-indexed)
Number of items per page
- Example request:
- BashCopied to clipboard
curl https://app.cloudcannon.com/api/v0/projects/{project_uuid}/sites \ -H "X-API-KEY: <your-api-key>" - Responses:
200OK
JSONCopied to clipboard[ { "uuid": "00000000-0000-0000-0000-000000000000", "id": 0, "site_name": "string", "subpath": "string", "stable_domain": "string", "ssg": "string", "last_synced": "2024-01-01T00:00:00Z", "last_output": "2024-01-01T00:00:00Z", "last_compiled": "2024-01-01T00:00:00Z", "last_compressed": "2024-01-01T00:00:00Z", "last_internationalised": "2024-01-01T00:00:00Z", "last_published": "2024-01-01T00:00:00Z", "last_cleaned": "2024-01-01T00:00:00Z", "storage_provider": "string", "client_author_name": "string", "client_author_email": "string", "create_source": "string", "hosting_choice": "string", "building_locked": true, "editing_locked": true, "uploads_locked": true, "browsing_locked": true, "last_compiled_success": "2024-01-01T00:00:00Z", "preview_url": "string", "documentation_url": "string", "support_url": "string", "client_editor_route": "string", "active_quest": "string", "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z", "mode": "string", "project_id": 0, "project_uuid": "string", "pr_number": 0, "pr_external_url": "string", "cloudcannon_config_path": "string", "output_storage_provider": "string", "domain_name": "string", "site_icon_state": "string", "sync_error": "string", "output_error": "string", "has_open_editing_session": true, "storage_provider_details": {}, "output_storage_provider_data": {}, "has_site_password": true, "has_client_password": true, "has_main_source_dam": true, "build_configuration": {} } ]401Unauthorized
JSONCopied to clipboard{ "error": "string" }403Forbidden
JSONCopied to clipboard{ "error": "string" }