--- title: "TagRelations.create" method: POST path: "/entities/TagRelations" tags: ["Tag"] --- # TagRelations.create `POST /entities/TagRelations` ## Request - Base URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id` - URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id/entities/TagRelations` - Auth: HTTP basic - TypeScript: (a function with typed inputs; its response is checked against the schema) Creates a TagRelation record. ## Query parameters - `validation-level` integer ## Request body - CreateTagRelationInput: Field values of a new TagRelation record. - `modified` string, date-time: Last modification time. - `created` string, date-time: Creation time. - `account_id` string, uuid: Id of the linked account. - `appointment_id` string, uuid: Id of the linked appointment. - `contact_id` string, uuid: Id of the linked contact. - `custom_entity_id` string, uuid: Id of the linked custom entity record. - `email_id` string, uuid: Id of the linked email. - `lead_id` string, uuid: Id of the linked lead. - `oppty_id` string, uuid: Id of the linked opportunity. - `process_id` string, uuid: Id of the linked sales process. - `project_id` string, uuid: Id of the linked project. - `quote_id` string, uuid: Id of the linked quote. - `solution_id` string, uuid: Id of the linked solution. - `tag_id` string, uuid, required: Id of the tag attached to the record. - `task_id` string, uuid: Id of the linked task. - `revision` integer: Revision when entity was lastly changed. ## Response `201` The created TagRelation record. - object - `success` boolean: True when the request succeeded; false on error. - `data` TagRelation: Assignment of a tag to a record. - `is_delete_protected` boolean, required: True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only. - `id` string, uuid, required: Unique identifier of entity. - `is_deleted` boolean: Specifies if the entity is considered deleted. - `modified` string, date-time: Last modification time. - `created` string, date-time: Creation time. - `account` string, uri: Account the tag is attached to, or empty when not attached to an account. Related Account record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Account' for its fields. - `appointment` string, uri: Appointment the tag is attached to, or empty when not attached to an appointment. Related Appointment record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Appointment' for its fields. - `contact` string, uri: Contact the tag is attached to, or empty when not attached to a contact. Related Contact record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Contact' for its fields. - `custom_entity` string, uri: Custom entity record the tag is attached to, or empty when not attached to a custom entity record. Related CustomEntity record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'CustomEntity' for its fields. - `email` string, uri: Email the tag is attached to, or empty when not attached to an email. Related Email record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Email' for its fields. - `lead` string, uri: Lead the tag is attached to, or empty when not attached to a lead. Related Lead record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Lead' for its fields. - `oppty` string, uri: Opportunity the tag is attached to, or empty when not attached to an opportunity. Related Opportunity record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Opportunity' for its fields. - `process` string, uri: Sales process the tag is attached to, or empty when not attached to a process. Related Process record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Process' for its fields. - `project` string, uri: Project the tag is attached to, or empty when not attached to a project. Related Project record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Project' for its fields. - `quote` string, uri: Quote the tag is attached to, or empty when not attached to a quote. Related Quote record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Quote' for its fields. - `solution` string, uri: Solution the tag is attached to, or empty when not attached to a solution. Related Solution record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Solution' for its fields. - `tag` string, uri, required: Tag being attached to the record. Related Tag record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Tag' for its fields. - `task` string, uri: Task the tag is attached to, or empty when not attached to a task. Related Task record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Task' for its fields. - `account_id` string, uuid: Id of the linked account. - `appointment_id` string, uuid: Id of the linked appointment. - `contact_id` string, uuid: Id of the linked contact. - `custom_entity_id` string, uuid: Id of the linked custom entity record. - `email_id` string, uuid: Id of the linked email. - `lead_id` string, uuid: Id of the linked lead. - `oppty_id` string, uuid: Id of the linked opportunity. - `process_id` string, uuid: Id of the linked sales process. - `project_id` string, uuid: Id of the linked project. - `quote_id` string, uuid: Id of the linked quote. - `solution_id` string, uuid: Id of the linked solution. - `tag_id` string, uuid, required: Id of the tag attached to the record. - `task_id` string, uuid: Id of the linked task. - `revision` integer: Revision when entity was lastly changed. ## Other responses - `400`: Bad request: a bad or unknown parameter (codes 117, 118), a missing permission (code 50), conflicting data (code 2002) or any other API error. The REST API answers 400 where others answer 403 or 409; check `code`. - `401`: Not authenticated: missing or wrong credentials, a credential of another space, or an expired token (code 401, ERROR_UNAUTHORIZED). - `422`: Validation failed (code 40000, with the failing fields) or a required parameter is missing (code 119). By default one failed item fails a whole batch and nothing is written. - `429`: Too many requests (code 182). Wait for the seconds in Retry-After, then retry. - `500`: Unexpected server error (code 1000, ERROR_UNKNOWN). --- [API](https://skmtc.dev/coevera/apis/coevera-crm-api.md) - [All operations](https://skmtc.dev/coevera/apis/coevera-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coevera/apis/coevera-crm-api/revisions/40ebbc83f179?raw)