> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osis.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Set a contact card

> PUT /api/v1/comms/contact-cards — save the hosted card for a dedicated-line agent.

Save the name, photo, and note a dedicated-line agent shows as its contact. People who text that number can add it.

Shared-line agents cannot set a card — one number cannot be many identities. Returns `409 dedicated_line_required`.

**Scope:** `comms_send` to write, `comms_read` to read.

## Set

```bash theme={null}
curl -X PUT "https://osis.co/api/v1/comms/contact-cards" \
  -H "Authorization: Bearer $COMMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_01HZX…",
    "name": "Jane Doe",
    "photo_url": "https://example.com/jane.jpg"
  }'
```

The number is always the agent's dedicated line. Hosted Settings → Identity has the same editor.

### Body

<ParamField body="agent_id" type="string" required>
  Dedicated-line agent.
</ParamField>

<ParamField body="name" type="string">
  Name on the card and the iMessage add-contact prompt.
</ParamField>

<ParamField body="email" type="string">
  Optional email.
</ParamField>

<ParamField body="note" type="string">
  Optional note.
</ParamField>

<ParamField body="photo_url" type="string">
  HTTPS JPEG, PNG, or GIF, max 200KB.
</ParamField>

<ParamField body="photo_base64" type="string">
  Same image as raw base64 or a data URL.
</ParamField>

<ParamField body="clear_photo" type="boolean">
  Drop the saved photo.
</ParamField>

## Read

```bash theme={null}
curl "https://osis.co/api/v1/comms/contact-cards?agent_id=agent_01HZX…" \
  -H "Authorization: Bearer $COMMS_API_KEY"
```

```json theme={null}
{
  "contact_card": {
    "agent_id": "agent_01HZX…",
    "name": "Jane Doe",
    "phone": "+16319869528",
    "has_photo": true,
    "dedicated": true,
    "line_synced": true
  }
}
```

`line_synced` is true when the dedicated iMessage line accepted the name and photo for Add Contact.