Proyek dan konten

Perbarui profil proyek

Ubah sebagian kolom profil merek proyek. Kolom yang tidak dikirim tetap sama. Memerlukan expected_profile_version dari pembacaan terbaru dan idempotency_key (peran editor).

POST /studio-api/projects/profile/update

Kontrak ditinjau: 2026-10-21 · sha256:563d2d581da0ad29

Baca sebagai Markdown Unduh kontrak publik Unduh OpenAPI

Ringkasan

Ubah sebagian kolom profil merek proyek. Kolom yang tidak dikirim tetap sama. Memerlukan expected_profile_version dari pembacaan terbaru dan idempotency_key (peran editor).

Respons HTTP berhasil dapat berarti permintaan diterima, bukan selesai. Untuk pekerjaan latar belakang, simpan ID yang dikembalikan dan periksa operasi yang sama sampai selesai. Postingan terjadwal atau diterima baru dipublikasikan setelah platform mengonfirmasi; timeout klien tidak membuktikan hasilnya.

Autentikasi dan izin

Jenis kredensial yang diterima: user_session, delegated_oauth, personal_access_token
Kemampuan yang didelegasikan: agent:operate
Peran ruang kerja minimum: editor
Cakupan akses: Sumber daya yang boleh diakses pengguna ini
Persetujuan seluruh ruang kerja diperlukan: Tidak
Mengubah status: Ya
Saat operasi selesai: synchronous_http_response

Token hanya dapat menggunakan hak pemiliknya. Setiap permintaan memeriksa keanggotaan ruang kerja, kepemilikan sumber daya, ruang kerja terpilih, dan kemampuan yang diberikan. Profil core dan full mengubah alat yang ditampilkan; tidak memberikan akses.

Kolom permintaan

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Kolom permintaan
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	`additionalProperties: false`
`project_id`	`string`Wajib dalam induk	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`expected_profile_version`	`integer`Wajib dalam induk	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`idempotency_key`	`string`Wajib dalam induk	`minLength: 8` `maxLength: 160`
`patch`	`object`Wajib dalam induk	`additionalProperties: false`
`patch.tagline`	`string \| null`Opsional / item	—
`patch.tagline`anyOf 1	`string`Opsional / item	`maxLength: 300`
`patch.tagline`anyOf 2	`null`Opsional / item	—
`patch.description`	`string \| null`Opsional / item	—
`patch.description`anyOf 1	`string`Opsional / item	`maxLength: 4000`
`patch.description`anyOf 2	`null`Opsional / item	—
`patch.voice`	`string \| null`Opsional / item	—
`patch.voice`anyOf 1	`string`Opsional / item	`maxLength: 1000`
`patch.voice`anyOf 2	`null`Opsional / item	—
`patch.target_audience`	`string \| null`Opsional / item	—
`patch.target_audience`anyOf 1	`string`Opsional / item	`maxLength: 1000`
`patch.target_audience`anyOf 2	`null`Opsional / item	—
`patch.color_palette`	`array`Opsional / item	`maxItems: 20`
`patch.color_palette[]`	`string`Opsional / item	`maxLength: 64`
`patch.goals`	`array`Opsional / item	`maxItems: 50`
`patch.goals[]`	`string`Opsional / item	`maxLength: 160`
`patch.no_go_topics`	`array`Opsional / item	`maxItems: 100`
`patch.no_go_topics[]`	`string`Opsional / item	`maxLength: 160`
`patch.language_primary`	`string`Opsional / item	`minLength: 2` `maxLength: 35`
`patch.positioning`	`string \| null`Opsional / item	—
`patch.positioning`anyOf 1	`string`Opsional / item	`maxLength: 2000`
`patch.positioning`anyOf 2	`null`Opsional / item	—
`patch.usp`	`string \| null`Opsional / item	—
`patch.usp`anyOf 1	`string`Opsional / item	`maxLength: 1000`
`patch.usp`anyOf 2	`null`Opsional / item	—
`patch.visual_identity`	`object \| null`Opsional / item	—
`patch.visual_identity`anyOf 1	`object`Opsional / item	`additionalProperties: {}`
`patch.visual_identity.*`anyOf 1	`any JSON value`Opsional / item	—
`patch.visual_identity`anyOf 2	`null`Opsional / item	—
`patch.forbidden_claims`	`array`Opsional / item	`maxItems: 100`
`patch.forbidden_claims[]`	`string`Opsional / item	`maxLength: 240`
`patch.north_star_metric`	`string \| null`Opsional / item	—
`patch.north_star_metric`anyOf 1	`string`Opsional / item	`maxLength: 300`
`patch.north_star_metric`anyOf 2	`null`Opsional / item	—
`patch.posting_cadence`	`object \| null`Opsional / item	—
`patch.posting_cadence`anyOf 1	`object`Opsional / item	`additionalProperties: {}`
`patch.posting_cadence.*`anyOf 1	`any JSON value`Opsional / item	—
`patch.posting_cadence`anyOf 2	`null`Opsional / item	—
`patch.app_store_url_ios`	`string \| null`Opsional / item	—
`patch.app_store_url_ios`anyOf 1	`string`Opsional / item	`format: "uri"`
`patch.app_store_url_ios`anyOf 2	`null`Opsional / item	—
`patch.app_store_url_android`	`string \| null`Opsional / item	—
`patch.app_store_url_android`anyOf 1	`string`Opsional / item	`format: "uri"`
`patch.app_store_url_android`anyOf 2	`null`Opsional / item	—
`patch.app_metadata`	`object`Opsional / item	`additionalProperties: {}`
`patch.app_metadata.*`	`any JSON value`Opsional / item	—

JSON Schema lengkap

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "expected_profile_version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160
    },
    "patch": {
      "type": "object",
      "properties": {
        "tagline": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 300
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4000
            },
            {
              "type": "null"
            }
          ]
        },
        "voice": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "target_audience": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "color_palette": {
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 64
          }
        },
        "goals": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 160
          }
        },
        "no_go_topics": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 160
          }
        },
        "language_primary": {
          "type": "string",
          "minLength": 2,
          "maxLength": 35
        },
        "positioning": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 2000
            },
            {
              "type": "null"
            }
          ]
        },
        "usp": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "visual_identity": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "forbidden_claims": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 240
          }
        },
        "north_star_metric": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 300
            },
            {
              "type": "null"
            }
          ]
        },
        "posting_cadence": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_ios": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_android": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_metadata": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "project_id",
    "expected_profile_version",
    "idempotency_key",
    "patch"
  ],
  "additionalProperties": false
}

Respons dan penyelesaian

Status HTTP berhasil: 200. Saat operasi selesai: synchronous_http_response.

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Respons dan penyelesaian
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	—
`contract_version`	`string`Wajib dalam induk	`const: "project/v1"`
`profile`	`object`Wajib dalam induk	—
`profile.project_id`	`string`Wajib dalam induk	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`profile.workspace_id`	`string`Wajib dalam induk	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`profile.tagline`	`string \| null`Wajib dalam induk	—
`profile.tagline`anyOf 1	`string`Wajib dalam induk	—
`profile.tagline`anyOf 2	`null`Wajib dalam induk	—
`profile.description`	`string \| null`Wajib dalam induk	—
`profile.description`anyOf 1	`string`Wajib dalam induk	—
`profile.description`anyOf 2	`null`Wajib dalam induk	—
`profile.voice`	`string \| null`Wajib dalam induk	—
`profile.voice`anyOf 1	`string`Wajib dalam induk	—
`profile.voice`anyOf 2	`null`Wajib dalam induk	—
`profile.target_audience`	`string \| null`Wajib dalam induk	—
`profile.target_audience`anyOf 1	`string`Wajib dalam induk	—
`profile.target_audience`anyOf 2	`null`Wajib dalam induk	—
`profile.color_palette`	`array`Wajib dalam induk	—
`profile.color_palette[]`	`string`Opsional / item	—
`profile.goals`	`array`Wajib dalam induk	—
`profile.goals[]`	`string`Opsional / item	—
`profile.no_go_topics`	`array`Wajib dalam induk	—
`profile.no_go_topics[]`	`string`Opsional / item	—
`profile.language_primary`	`string`Wajib dalam induk	—
`profile.positioning`	`string \| null`Wajib dalam induk	—
`profile.positioning`anyOf 1	`string`Wajib dalam induk	—
`profile.positioning`anyOf 2	`null`Wajib dalam induk	—
`profile.usp`	`string \| null`Wajib dalam induk	—
`profile.usp`anyOf 1	`string`Wajib dalam induk	—
`profile.usp`anyOf 2	`null`Wajib dalam induk	—
`profile.visual_identity`	`object \| null`Wajib dalam induk	—
`profile.visual_identity`anyOf 1	`object`Wajib dalam induk	`additionalProperties: {}`
`profile.visual_identity.*`anyOf 1	`any JSON value`Opsional / item	—
`profile.visual_identity`anyOf 2	`null`Wajib dalam induk	—
`profile.forbidden_claims`	`array`Wajib dalam induk	—
`profile.forbidden_claims[]`	`string`Opsional / item	—
`profile.north_star_metric`	`string \| null`Wajib dalam induk	—
`profile.north_star_metric`anyOf 1	`string`Wajib dalam induk	—
`profile.north_star_metric`anyOf 2	`null`Wajib dalam induk	—
`profile.posting_cadence`	`object \| null`Wajib dalam induk	—
`profile.posting_cadence`anyOf 1	`object`Wajib dalam induk	`additionalProperties: {}`
`profile.posting_cadence.*`anyOf 1	`any JSON value`Opsional / item	—
`profile.posting_cadence`anyOf 2	`null`Wajib dalam induk	—
`profile.app_store_url_ios`	`string \| null`Wajib dalam induk	—
`profile.app_store_url_ios`anyOf 1	`string`Wajib dalam induk	—
`profile.app_store_url_ios`anyOf 2	`null`Wajib dalam induk	—
`profile.app_store_url_android`	`string \| null`Wajib dalam induk	—
`profile.app_store_url_android`anyOf 1	`string`Wajib dalam induk	—
`profile.app_store_url_android`anyOf 2	`null`Wajib dalam induk	—
`profile.app_metadata`	`object`Wajib dalam induk	`additionalProperties: {}`
`profile.app_metadata.*`	`any JSON value`Opsional / item	—
`profile.profile_version`	`integer`Wajib dalam induk	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`profile.updated_by`	`string \| null`Wajib dalam induk	—
`profile.updated_by`anyOf 1	`string`Wajib dalam induk	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`profile.updated_by`anyOf 2	`null`Wajib dalam induk	—
`profile.updated_by_kind`	`string`Wajib dalam induk	`enum: ["jwt","api_key","delegated_ai","migration"]`
`profile.updated_by_api_key_id`	`string \| null`Wajib dalam induk	—
`profile.updated_by_api_key_id`anyOf 1	`string`Wajib dalam induk	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`profile.updated_by_api_key_id`anyOf 2	`null`Wajib dalam induk	—
`profile.updated_by_delegated_grant_id`	`string \| null`Wajib dalam induk	—
`profile.updated_by_delegated_grant_id`anyOf 1	`string`Wajib dalam induk	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`profile.updated_by_delegated_grant_id`anyOf 2	`null`Wajib dalam induk	—
`profile.created_at`	`string`Wajib dalam induk	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`profile.updated_at`	`string`Wajib dalam induk	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`receipt_id`	`string`Wajib dalam induk	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`applied`	`boolean`Wajib dalam induk	—
`deduped`	`boolean`Wajib dalam induk	—

JSON Schema lengkap

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "project/v1"
    },
    "profile": {
      "type": "object",
      "properties": {
        "project_id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "tagline": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "voice": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "target_audience": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "color_palette": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "goals": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "no_go_topics": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "language_primary": {
          "type": "string"
        },
        "positioning": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "usp": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "visual_identity": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "forbidden_claims": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "north_star_metric": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "posting_cadence": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_ios": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_android": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_metadata": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "profile_version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "updated_by": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_by_kind": {
          "type": "string",
          "enum": [
            "jwt",
            "api_key",
            "delegated_ai",
            "migration"
          ]
        },
        "updated_by_api_key_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_by_delegated_grant_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        }
      },
      "required": [
        "project_id",
        "workspace_id",
        "tagline",
        "description",
        "voice",
        "target_audience",
        "color_palette",
        "goals",
        "no_go_topics",
        "language_primary",
        "positioning",
        "usp",
        "visual_identity",
        "forbidden_claims",
        "north_star_metric",
        "posting_cadence",
        "app_store_url_ios",
        "app_store_url_android",
        "app_metadata",
        "profile_version",
        "updated_by",
        "updated_by_kind",
        "updated_by_api_key_id",
        "updated_by_delegated_grant_id",
        "created_at",
        "updated_at"
      ]
    },
    "receipt_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "applied": {
      "type": "boolean"
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "contract_version",
    "profile",
    "receipt_id",
    "applied",
    "deduped"
  ]
}

Kesalahan dan percobaan ulang aman

Periksa status HTTP dan isi respons. Kesalahan validasi 400 mungkin berisi ZodError; kesalahan handler menggunakan kolom error, message, dan code. Simpan request_id atau x-request-id untuk diagnosis, tanpa kredensial. Atasi kesalahan akses 401/403 sebelum mencoba lagi, dan ikuti Retry-After untuk 429. Jika penulisan belum pasti atau mengembalikan 5xx, baca hasil yang sudah ada terlebih dahulu. Gunakan kembali kunci idempotensi hanya jika didukung; perilaku percobaan ulang berbeda menurut operasi dan tidak menjamin pengiriman tepat satu kali.

Panduan pemecahan masalah

Contoh

Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan API.

Atur SOSOAPI_ACCESS_TOKEN di server Anda ke kredensial yang diterima operasi ini, dan jauhkan dari kode browser. Untuk agen, gunakan sosoapi auth login untuk masuk melalui browser dan biarkan CLI memperbarui kredensialnya.

request.json

{
  "project_id": "11111111-1111-4111-8111-111111111111",
  "expected_profile_version": 1,
  "idempotency_key": "example-intent-0001",
  "patch": {
    "tagline": "A fictional project for the documentation example."
  }
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/projects/profile/update" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/projects/profile/update", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "project_id": "11111111-1111-4111-8111-111111111111",
  "expected_profile_version": 1,
  "idempotency_key": "example-intent-0001",
  "patch": {
    "tagline": "A fictional project for the documentation example."
  }
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /studio-api/projects/profile/update < request.json

Contoh respons sintetis

{
  "contract_version": "project/v1",
  "profile": {
    "project_id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "tagline": null,
    "description": null,
    "voice": null,
    "target_audience": null,
    "color_palette": [],
    "goals": [],
    "no_go_topics": [],
    "language_primary": "example",
    "positioning": null,
    "usp": null,
    "visual_identity": null,
    "forbidden_claims": [],
    "north_star_metric": null,
    "posting_cadence": null,
    "app_store_url_ios": null,
    "app_store_url_android": null,
    "app_metadata": {},
    "profile_version": 1,
    "updated_by": null,
    "updated_by_kind": "jwt",
    "updated_by_api_key_id": null,
    "updated_by_delegated_grant_id": null,
    "created_at": "2099-01-15T09:00:00Z",
    "updated_at": "2099-01-15T09:00:00Z"
  },
  "receipt_id": "11111111-1111-4111-8111-111111111111",
  "applied": false,
  "deduped": false
}

MCP: sosoapi_update_project_profile

Semua operasi API Autentikasi dan izin