Ads APIReferences / businesses / Update Business

Update Business

Update the given existing business.

Request

  • business_idstring [uuid]
    Required

    A unique identifier for the entity.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • namestring
    Required

    The name of the business.

    Pattern: ^(?!\s*$).+Length between 1 and 255Example: "My Ad Studio Business"

Response

Metadata for a business.

  • idstring [uuid]

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • namestring

    The name of the business.

    Pattern: ^(?!\s*$).+Length between 1 and 255Example: "My Ad Studio Business"
  • created_atstring [date-time]

    Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • updated_atstring [date-time]

    Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • statusstring

    The status of the business.

    Allowed values: "ACTIVE"
  • typestring

    The type of the business.

    Allowed values: "ADVERTISER", "AGENCY", "MUSIC_ARTIST_CONCERT_PROMOTER", "PODCAST_PROMOTER"

Response sample

{  "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",  "name": "My Ad Studio Business",  "created_at": "2026-01-23T04:56:07Z",  "updated_at": "2026-01-23T04:56:07Z",  "status": "ACTIVE",  "type": "ADVERTISER"}