# Send the launch filing

Sends the launch filing.

```http
POST https://api.pozy.ai/v1/rcs/agents/{agentId}/launch-request
```

- Area: Messaging / RCS
- Auth: Authorization: Bearer pz_live_...

## Path parameters

- `agentId` (string, required)

## Request body

Content type: `application/json`

- `companyOverview`, string, required: Up to 2000 characters
- `agentOverview`, string, required: Up to 2000 characters
- `interactions`, array of object, required: At least 1 item
  - `type`, string, required: One of `TRANSACTIONAL_UPDATES`, `CUSTOMER_SUPPORT`, `LOYALTY_OR_REWARD`, `MARKETING_OR_PROMOTIONAL`, `ACCOUNT_ALERTS`, `TWO_WAY_CONVERSATION`, `OTHER`
  - `description`, string
- `messageExamples`, array of string, required: At least 3 items. Up to 10 items. Each item: up to 2000 characters
- `consent`, object, required
  - `optInMethods`, array of object, required: At least 1 item
    - `type`, string, required: One of `SMS`, `WEBSITE`, `MOBILE_APP`, `QR_CODE`, `SALE_POINT`, `OTHER`
    - `description`, string
  - `callToAction`, string, required
  - `callToActionUrl`, string (URL)
  - `callToActionMediaUrl`, string (URL)
  - `doubleOptIn`, boolean, required
  - `doubleOptInMessage`, string
  - `optInMessage`, string, required
  - `helpResponse`, string, required
  - `optOutResponse`, string, required
- `testVideoUrl`, string (URL), required
- `additionalInformation`, string: Up to 2000 characters

## Example request

```bash
curl -X POST "https://api.pozy.ai/v1/rcs/agents/6b99fbd950277956c14bd44d/launch-request" \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "companyOverview": "string",
  "agentOverview": "string",
  "interactions": [
    {
      "type": "TRANSACTIONAL_UPDATES"
    }
  ],
  "messageExamples": [
    "Hello from Pozy"
  ],
  "consent": {
    "optInMethods": [
      {
        "type": "SMS"
      }
    ],
    "callToAction": "string",
    "doubleOptIn": true,
    "optInMessage": "Hello from Pozy",
    "helpResponse": "string",
    "optOutResponse": "string"
  },
  "testVideoUrl": "https://pozy.ai/media/example-1.jpg"
}'
```

```ts
const res = await fetch("https://api.pozy.ai/v1/rcs/agents/6b99fbd950277956c14bd44d/launch-request", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    companyOverview: "string",
    agentOverview: "string",
    interactions: [
      {
        type: "TRANSACTIONAL_UPDATES"
      }
    ],
    messageExamples: [
      "Hello from Pozy"
    ],
    consent: {
      optInMethods: [
        {
          type: "SMS"
        }
      ],
      callToAction: "string",
      doubleOptIn: true,
      optInMessage: "Hello from Pozy",
      helpResponse: "string",
      optOutResponse: "string"
    },
    testVideoUrl: "https://pozy.ai/media/example-1.jpg"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.post(
    "https://api.pozy.ai/v1/rcs/agents/6b99fbd950277956c14bd44d/launch-request",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "companyOverview": "string",
        "agentOverview": "string",
        "interactions": [
            {
                "type": "TRANSACTIONAL_UPDATES",
            },
        ],
        "messageExamples": [
            "Hello from Pozy",
        ],
        "consent": {
            "optInMethods": [
                {
                    "type": "SMS",
                },
            ],
            "callToAction": "string",
            "doubleOptIn": True,
            "optInMessage": "Hello from Pozy",
            "helpResponse": "string",
            "optOutResponse": "string",
        },
        "testVideoUrl": "https://pozy.ai/media/example-1.jpg",
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `agent`, object
  - `id`, string
  - `profileId`, string
  - `accountId`, string: Can be null
  - `country`, string
  - `status`, string: One of `requested`, `changes_requested`, `brand_vetting`, `agent_review`, `testing`, `launch_review`, `launching`, `live`, `rejected`, `deactivated`
  - `displayName`, string: Up to 40 characters
  - `useCase`, string: One of `MULTI_USE`, `PROMOTIONAL`, `TRANSACTIONAL`, `OTP`
  - `profile`, object
    - `description`, string, required: Up to 100 characters
    - `logoUrl`, string (URL), required
    - `heroUrl`, string (URL), required
    - `brandColor`, string, required
    - `privacyPolicyUrl`, string (URL), required
    - `termsUrl`, string (URL), required
    - `phone`, object
      - `number`, string, required
      - `label`, string, required: Up to 25 characters
    - `website`, object
      - `url`, string (URL), required
      - `label`, string, required: Up to 25 characters
    - `email`, object
      - `address`, string (email), required
      - `label`, string, required: Up to 25 characters
  - `brand`, object
    - one of: Rcs Brand
      - `displayName`, string, required: Up to 100 characters
      - `legalName`, string, required: Up to 100 characters
      - `legalEntityType`, string, required: One of `LIMITED_LIABILITY_COMPANY`, `SOLE_PROPRIETORSHIP`, `PARTNERSHIP`, `CORPORATION`, `S_CORPORATION`
      - `organizationType`, string, required: One of `PRIVATE_PROFIT`, `PUBLIC_PROFIT`, `NON_PROFIT`, `GOVERNMENT`
      - `websiteUrl`, string (URL), required
      - `taxId`, string, required
      - `stockSymbol`, string
      - `address`, object, required
        - `line1`, string, required
        - `line2`, string
        - `city`, string, required
        - `state`, string
        - `postalCode`, string, required
        - `country`, string, required: One of `US`, `GB`, `AT`, `BD`, `BR`, `CD`, `DE`, `ES`, `FR`, `IN`, `IT`, `MX`, `NG`, `NL`, `NO`, `PT`, `SE`, `SG`, `ZA`
      - `contact`, object, required
        - `firstName`, string, required
        - `lastName`, string, required
        - `title`, string
        - `email`, string (email), required
        - `phone`, string, required
      - `id`, string
      - `status`, string: One of `draft`, `vetting`, `verified`, `rejected`
      - `createdAt`, string (date-time)
  - `launchRequest`, object
    - one of: Rcs Launch Request
      - `companyOverview`, string, required: Up to 2000 characters
      - `agentOverview`, string, required: Up to 2000 characters
      - `interactions`, array of object, required: At least 1 item
        - `type`, string, required: One of `TRANSACTIONAL_UPDATES`, `CUSTOMER_SUPPORT`, `LOYALTY_OR_REWARD`, `MARKETING_OR_PROMOTIONAL`, `ACCOUNT_ALERTS`, `TWO_WAY_CONVERSATION`, `OTHER`
        - `description`, string
      - `messageExamples`, array of string, required: At least 3 items. Up to 10 items. Each item: up to 2000 characters
      - `consent`, object, required
        - `optInMethods`, array of object, required: At least 1 item
          - `type`, string, required: One of `SMS`, `WEBSITE`, `MOBILE_APP`, `QR_CODE`, `SALE_POINT`, `OTHER`
          - `description`, string
        - `callToAction`, string, required
        - `callToActionUrl`, string (URL)
        - `callToActionMediaUrl`, string (URL)
        - `doubleOptIn`, boolean, required
        - `doubleOptInMessage`, string
        - `optInMessage`, string, required
        - `helpResponse`, string, required
        - `optOutResponse`, string, required
      - `testVideoUrl`, string (URL), required
      - `additionalInformation`, string: Up to 2000 characters
  - `carrierApprovals`, array of object
    - `approvalId`, string
    - `scope`, string: One of `carrier`, `hub`, `bot`
    - `status`, string: One of `PENDING`, `SUBMITTED`, `APPROVED`, `REJECTED`
    - `carrier`, string: Can be null
    - `approvedAt`, string (date-time): Can be null
    - `rejectedReason`, string: Can be null
  - `testDevices`, array of object
    - `testDeviceId`, string
    - `phoneNumber`, string
    - `inviteStatus`, string: One of `PENDING`, `ACCEPTED`, `DECLINED`
  - `smsFallbackFrom`, string: Can be null
  - `reviewNote`, string: Can be null
  - `declineReason`, string: Can be null
  - `requestedAt`, string (date-time): Can be null
  - `submittedAt`, string (date-time): Can be null
  - `liveAt`, string (date-time): Can be null
  - `createdAt`, string (date-time)

```json
{
  "agent": {
    "id": "6bfebd43ddc270f6d2c56fc5",
    "profileId": "6a0b6573846efc28aaa9a3ff",
    "accountId": "696e0b682d0a31188e7a2ba9",
    "country": "US",
    "status": "requested",
    "displayName": "Acme",
    "useCase": "MULTI_USE",
    "profile": {
      "description": "A short description",
      "logoUrl": "https://pozy.ai/media/example-1.jpg",
      "heroUrl": "https://pozy.ai/media/example-1.jpg",
      "brandColor": "string",
      "privacyPolicyUrl": "https://pozy.ai/media/example-1.jpg",
      "termsUrl": "https://pozy.ai/media/example-1.jpg",
      "phone": {
        "number": "string",
        "label": "string"
      },
      "website": {
        "url": "https://pozy.ai/media/example-1.jpg",
        "label": "string"
      },
      "email": {
        "address": "alex@example.com",
        "label": "string"
      }
    },
    "brand": {
      "displayName": "Acme",
      "legalName": "Acme",
      "legalEntityType": "LIMITED_LIABILITY_COMPANY",
      "organizationType": "PRIVATE_PROFIT",
      "websiteUrl": "https://pozy.ai/media/example-1.jpg",
      "taxId": "6e274285e4e83c5f91aee85e",
      "stockSymbol": "string",
      "address": {
        "line1": "string",
        "line2": "string",
        "city": "string",
        "state": "string",
        "postalCode": "string",
        "country": "US"
      },
      "contact": {
        "firstName": "Acme",
        "lastName": "Acme",
        "title": "Launch day",
        "email": "alex@example.com",
        "phone": "+14155550123"
      },
      "id": "6bfebd43ddc270f6d2c56fc5",
      "status": "draft",
      "createdAt": "2026-10-02T09:00:00.000Z"
    },
    "launchRequest": {
      "companyOverview": "string",
      "agentOverview": "string",
      "interactions": [
        {
          "type": "TRANSACTIONAL_UPDATES",
          "description": "A short description"
        }
      ],
      "messageExamples": [
        "Hello from Pozy"
      ],
      "consent": {
        "optInMethods": [
          {
            "type": "SMS",
            "description": "A short description"
          }
        ],
        "callToAction": "string",
        "callToActionUrl": "https://pozy.ai/media/example-1.jpg",
        "callToActionMediaUrl": "https://pozy.ai/media/example-1.jpg",
        "doubleOptIn": true,
        "doubleOptInMessage": "Hello from Pozy",
        "optInMessage": "Hello from Pozy",
        "helpResponse": "string",
        "optOutResponse": "string"
      },
      "testVideoUrl": "https://pozy.ai/media/example-1.jpg",
      "additionalInformation": "string"
    },
    "carrierApprovals": [
      {
        "approvalId": "66666666666666661f2e3d4c",
        "scope": "carrier",
        "status": "PENDING",
        "carrier": "string",
        "approvedAt": "2026-10-02T09:00:00.000Z",
        "rejectedReason": "string"
      }
    ],
    "testDevices": [
      {
        "testDeviceId": "653426651346b544a97028d1",
        "phoneNumber": "+14155550123",
        "inviteStatus": "PENDING"
      }
    ],
    "smsFallbackFrom": "string",
    "reviewNote": "string",
    "declineReason": "string",
    "requestedAt": "2026-10-02T09:00:00.000Z",
    "submittedAt": "2026-10-02T09:00:00.000Z",
    "liveAt": "2026-10-02T09:00:00.000Z",
    "createdAt": "2026-10-02T09:00:00.000Z"
  }
}
```