# API reference

- [Manage workspace contacts](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts.md): The following endpoints allow for creating contacts and managing their life cycle.
- [Create a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/create-a-contact.md)
- [Get a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/get-a-contact.md)
- [List contacts](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/list-contacts.md)
- [Search contact by identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/search-contact-by-identifier.md)
- [Update a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/update-a-contact.md)
- [Create or update a contact by identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/create-or-update-a-contact-by-identifier.md)
- [Delete a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/delete-a-contact.md)
- [Manage contact identifiers](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers.md): The following endpoints allow for managing the identifiers for a single contact.
- [Create contact identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers/create-contact-identifier.md)
- [List contact identifiers](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers/list-contact-identifiers.md)
- [Delete contact identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers/delete-contact-identifier.md)
- [Manage contact attribute definition](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition.md): The following endpoints allow for managing the custom attribute schema for your contacts.
- [Create attribute definition](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition/create-attribute-definition.md)
- [Get attribute definition](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition/get-attribute-definition.md)
- [List attribute definitions](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition/list-attribute-definitions.md)
- [Manage contact lists](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists.md): The following endpoints allow for creating contact lists and managing their life cycle.
- [Create a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/create-a-list.md)
- [Get a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/get-a-list.md)
- [List lists](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/list-lists.md)
- [Update a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/update-a-list.md)
- [Delete a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/delete-a-list.md)
- [Add contacts to a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/add-contacts-to-a-list.md)
- [Get contact list memberships](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/get-contact-list-memberships.md)
- [List contacts in a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/list-contacts-in-a-list.md)
- [Remove contacts from a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/remove-contacts-from-a-list.md)
- [Manage contact suppressions](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions.md): The following endpoints allow for managing suppressions for a single identifier value.
- [Upsert a workspace-platform-level suppression](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions/upsert-a-workspace-platform-level-suppression.md)
- [Get a suppression](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions/get-a-suppression.md)
- [List workspace-platform-level suppressions](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions/list-workspace-platform-level-suppressions.md)
- [Manage custom objects](https://docs.bird.com/api/contacts-api/api-reference/manage-custom-objects.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/api/contacts-api/api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.