Daylite Roles API
The Roles API from Daylite — 3 operation(s) for roles.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/daylite:daylite-roles-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: api-settings Roles API
version: '1'
servers:
- url: https://api.marketcircle.net/v1
security:
- sec0: []
tags:
- name: Roles
paths:
/roles:
get:
summary: Roles
description: List all roles. Each entry has the role reference and, if set, its title.
operationId: roles
responses:
'200':
description: 200 OK
content:
application/json:
examples:
Result:
value: "[\n {\n \"self\": \"/v1/roles/1000\",\n \"title\": \"Interim CEO\"\n },\n {\n \"self\": \"/v1/roles/1001\"\n }\n]"
deprecated: false
tags:
- Roles
post:
summary: Role
description: Create a role between two records
operationId: role-create
requestBody:
content:
application/json:
schema:
type: object
properties:
contact:
type: string
description: Reference of the contact, e.g. `/v1/contacts/1000`.
company:
type: string
description: Reference of the company, e.g. `/v1/companies/1000`.
opportunity:
type: string
description: Reference of the opportunity, e.g. `/v1/opportunities/1000`.
project:
type: string
description: Reference of the project, e.g. `/v1/projects/1000`.
type:
type: string
description: Reference of the [role type](ref:role_type), e.g. `/v1/role_types/1000`. Optional.
title:
type: string
description: Title, e.g. a job title (max 128 characters).
department:
type: string
description: Department (max 128 characters). Only allowed on roles between a contact and a company.
responses:
'201':
description: 201 Created
content:
application/json:
examples:
Result:
value: "{\n \"location\": \"/v1/roles/1000\"\n}"
'400':
description: 400 Bad Request
content:
application/json:
examples:
Department on the wrong kind of role:
value: "{\n \"department\": [\n {\n \"error\": \"must_be_blank_unless_contact_company_role\"\n }\n ]\n}"
Sending role:
value: "{\n \"base\": [\n {\n \"error\": \"role_cannot_be_set\"\n }\n ]\n}"
deprecated: false
tags:
- Roles
/roles/_search:
post:
summary: Role Search
description: Search for roles
operationId: role-search
parameters:
- name: limit
in: query
description: Maximum number of results per page (max 250). Defaults to 50, or 10 when `full-records` is `true`.
schema:
type: integer
format: int32
default: 50
maximum: 250
- name: full-records
in: query
description: Return every attribute of each result instead of the short list form.
schema:
type: boolean
- name: start
in: query
description: Return results whose ID is greater than or equal to this value. Use the `next` URL from the previous page rather than building this yourself.
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
type: object
properties:
title:
type: object
description: 'Example: `Interim CEO`'
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
department:
type: object
description: 'Example: `Executive`'
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
contact:
type: object
description: 'The contact. Match by reference with `equal` or `not_equal`, e.g. `{"equal": "/v1/contacts/1000"}`, or by any contact attribute with `any`, e.g. `{"any": {"name": {"equal": "Acme"}}}`.'
properties:
equal:
type: string
not_equal:
type: string
any:
type: object
description: A [contact search](ref:contact-search) filter
properties:
first_name:
type: object
description: First name
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
last_name:
type: object
description: Last name
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
company:
type: object
description: 'The company. Match by reference with `equal` or `not_equal`, e.g. `{"equal": "/v1/companies/1000"}`, or by any company attribute with `any`, e.g. `{"any": {"name": {"equal": "Acme"}}}`.'
properties:
equal:
type: string
not_equal:
type: string
any:
type: object
description: A [company search](ref:company-search) filter
properties:
name:
type: object
description: Company name
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
opportunity:
type: object
description: 'The opportunity. Match by reference with `equal` or `not_equal`, e.g. `{"equal": "/v1/opportunities/1000"}`, or by any opportunity attribute with `any`, e.g. `{"any": {"name": {"equal": "Acme"}}}`.'
properties:
equal:
type: string
not_equal:
type: string
any:
type: object
description: A [opportunity search](ref:opportunity-search) filter
properties:
name:
type: object
description: Opportunity name
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
project:
type: object
description: 'The project. Match by reference with `equal` or `not_equal`, e.g. `{"equal": "/v1/projects/1000"}`, or by any project attribute with `any`, e.g. `{"any": {"name": {"equal": "Acme"}}}`.'
properties:
equal:
type: string
not_equal:
type: string
any:
type: object
description: A [project search](ref:project-search) filter
properties:
name:
type: object
description: Project name
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
type:
type: object
description: 'The role type. Match by reference with `equal` or `not_equal`, e.g. `{"equal": "/v1/role_types/1000"}`, or by any role type attribute with `any`, e.g. `{"any": {"role_name": {"equal": "Decision Maker"}}}`.'
properties:
equal:
type: string
not_equal:
type: string
any:
type: object
description: A [role type search](ref:role_type-search) filter
properties:
role_name:
type: object
description: Role type name
properties:
equal:
type: string
not_equal:
type: string
equal_ignore_case:
type: string
starts_with:
type: string
does_not_start_with:
type: string
ends_with:
type: string
does_not_end_with:
type: string
contains:
type: string
does_not_contain:
type: string
any:
type: array
items:
type: string
not_any:
type: array
items:
type: string
any_ignore_case:
type: array
items:
type: string
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
role_id:
type: object
description: The role's numeric ID
properties:
equal:
type: integer
not_equal:
type: integer
less_than:
type: integer
less_than_equal:
type: integer
greater_than:
type: integer
greater_than_equal:
type: integer
in_range:
type: array
items:
type: integer
minItems: 2
maxItems: 2
description: 'Two values: `[from, to]`, inclusive'
not_in_range:
type: array
items:
type: integer
minItems: 2
maxItems: 2
description: 'Two values: `[from, to]`, inclusive'
any:
type: array
items:
type: integer
not_any:
type: array
items:
type: integer
blank:
type: boolean
description: Value is ignored
not_blank:
type: boolean
description: Value is ignored
responses:
'200':
description: 200 OK
content:
application/json:
examples:
Result:
value: "{\n \"results\": [\n {\n \"self\": \"/v1/roles/1000\",\n \"title\": \"Interim CEO\"\n },\n {\n \"self\": \"/v1/roles/1001\"\n }\n ],\n \"next\": \"/v1/roles/_search?start=2001\"\n}"
'400':
description: 400 Bad Request
content:
application/json:
examples:
Result:
value: "{\n \"error\": \"unsupported_operator\",\n \"attribute\": \"title\",\n \"operator\": \"less_than\",\n \"operand\": \"M\"\n}"
deprecated: false
tags:
- Roles
/roles/{id}:
get:
summary: Role
description: Show the details of a role
operationId: role
parameters:
- name: id
in: path
description: The role ID
schema:
type: integer
format: int32
required: true
responses:
'200':
description: 200 OK
content:
application/json:
examples:
Result:
value: "{\n \"self\": \"/v1/roles/1000\",\n \"title\": \"Interim CEO\",\n \"department\": \"Executive\",\n \"company\": \"/v1/companies/1000\",\n \"contact\": \"/v1/contacts/1000\",\n \"type\": \"/v1/role_types/1000\",\n \"role\": \"Decision Maker\",\n \"create_date\": \"2025-03-04T17:45:57.000Z\",\n \"trashed\": false\n}"
'404':
description: 404 Not Found
content:
application/json:
examples:
Result:
value: "{\n \"error\": \"role_not_found\"\n}"
deprecated: false
tags:
- Roles
patch:
summary: Role
description: Update a role
operationId: role-edit
parameters:
- name: id
in: path
description: The role ID
schema:
type: integer
format: int32
required: true
requestBody:
content:
application/json:
schema:
type: object
properties:
contact:
type: string
description: Reference of the contact, e.g. `/v1/contacts/1000`.
company:
type: string
description: Reference of the company, e.g. `/v1/companies/1000`.
opportunity:
type: string
description: Reference of the opportunity, e.g. `/v1/opportunities/1000`.
project:
type: string
description: Reference of the project, e.g. `/v1/projects/1000`.
type:
type: string
description: Reference of the [role type](ref:role_type), e.g. `/v1/role_types/1000`. Optional.
title:
type: string
description: Title, e.g. a job title (max 128 characters).
department:
type: string
description: Department (max 128 characters). Only allowed on roles between a contact and a company.
trashed:
type: boolean
description: Set to `false` to restore the role from the trash. Use DELETE to move it to the trash.
responses:
'204':
description: 204 No Content
'400':
description: 400 Bad Request
content:
application/json:
examples:
Result:
value: "{\n \"title\": [\n {\n \"error\": \"too_long\",\n \"count\": 128\n }\n ]\n}"
'404':
description: 404 Not Found
content:
application/json:
examples:
Result:
value: "{\n \"error\": \"invalid_id\"\n}"
deprecated: false
tags:
- Roles
delete:
summary: Role
description: Move a role to the trash, or permanently delete it if it is already in the trash
operationId: role-delete
parameters:
- name: id
in: path
description: The role ID
schema:
type: integer
format: int32
required: true
responses:
'204':
description: 204 No Content
'404':
description: 404 Not Found
content:
application/json:
examples:
Result:
value: "{\n \"error\": \"invalid_id\"\n}"
deprecated: false
tags:
- Roles
components:
securitySchemes:
sec0:
type: apiKey
in: header
name: Authorization
x-bearer-format: bearer
x-readme-fauxas: true
x-provenance:
method: searched
source: https://developer.daylite.app/reference
harvested: '2026-10-26'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developer.daylite.app/reference/appointment-create.md
- https://developer.daylite.app/reference/appointment-delete.md
- https://developer.daylite.app/reference/appointment-edit.md
- https://developer.daylite.app/reference/appointment-emails.md
- https://developer.daylite.app/reference/appointment-search.md
- https://developer.daylite.app/reference/appointment-trash-details.md
- https://developer.daylite.app/reference/appointment-trash.md
- https://developer.daylite.app/reference/appointment.md
- https://developer.daylite.app/reference/appointments.md
- https://developer.daylite.app/reference/categories.md
- https://developer.daylite.app/reference/category-delete.md
- https://developer.daylite.app/reference/category-details.md
- https://developer.daylite.app/reference/companies.md
- https://developer.daylite.app/reference/company-create.md
- https://developer.daylite.app/reference/company-delete.md
- https://developer.daylite.app/reference/company-details.md
- https://developer.daylite.app/reference/company-edit.md
- https://developer.daylite.app/reference/company-emails.md
- https://developer.daylite.app/reference/company-extra-fields-edit.md
- https://developer.daylite.app/reference/company-extra-fields.md
- https://developer.daylite.app/reference/company-image-destroy.md
- https://developer.daylite.app/reference/company-image-update.md
- https://developer.daylite.app/reference/company-image.md
- https://developer.daylite.app/reference/company-search.md
- https://developer.daylite.app/reference/company-trash-details.md
- https://developer.daylite.app/reference/company-trash.md
- https://developer.daylite.app/reference/company_type-details.md
- https://developer.daylite.app/reference/company_types.md
- https://developer.daylite.app/reference/contact-create.md
- https://developer.daylite.app/reference/contact-delete.md
- https://developer.daylite.app/reference/contact-details.md
- https://developer.daylite.app/reference/contact-edit.md
- https://developer.daylite.app/reference/contact-emails.md
- https://developer.daylite.app/reference/contact-extra-fields-edit.md
- https://developer.daylite.app/reference/contact-extra-fields.md
- https://developer.daylite.app/reference/contact-image-destroy.md
- https://developer.daylite.app/reference/contact-image-update.md
- https://developer.daylite.app/reference/contact-image.md
- https://developer.daylite.app/reference/contact-search.md
- https://developer.daylite.app/reference/contact-trash-details.md
- https://developer.daylite.app/reference/contact-trash.md
- https://developer.daylite.app/reference/contacts.md
- https://developer.daylite.app/reference/create-form-definition.md
- https://developer.daylite.app/reference/create-subscription.md
- https://developer.daylite.app/reference/delete-subscription.md
- https://developer.daylite.app/reference/email-1.md
- https://developer.daylite.app/reference/email-body-search.md
- https://developer.daylite.app/reference/email-body-update.md
- https://developer.daylite.app/reference/email-body.md
- https://developer.daylite.app/reference/email-create.md
- https://developer.daylite.app/reference/email-delete.md
- https://developer.daylite.app/reference/email-metadata.md
- https://developer.daylite.app/reference/email-search.md
- https://developer.daylite.app/reference/email-trash-details.md
- https://developer.daylite.app/reference/email-trash.md
- https://developer.daylite.app/reference/email.md
- https://developer.daylite.app/reference/emails.md
- https://developer.daylite.app/reference/file-content-set.md
- https://developer.daylite.app/reference/file-content.md
- https://developer.daylite.app/reference/file-create.md
- https://developer.daylite.app/reference/file-edit.md
- https://developer.daylite.app/reference/file-emails.md
- https://developer.daylite.app/reference/file-remove.md
- https://developer.daylite.app/reference/file-search.md
- https://developer.daylite.app/reference/file-trash-details.md
- https://developer.daylite.app/reference/file-trash.md
- https://developer.daylite.app/reference/file.md
- https://developer.daylite.app/reference/files.md
- https://developer.daylite.app/reference/form-2.md
- https://developer.daylite.app/reference/form-definition-delete.md
- https://developer.daylite.app/reference/form-definition-edit.md
- https://developer.daylite.app/reference/form-definition-trash-details.md
- https://developer.daylite.app/reference/form-definition-trash.md
- https://developer.daylite.app/reference/form-definition.md
- https://developer.daylite.app/reference/form-details.md
- https://developer.daylite.app/reference/form-edit.md
- https://developer.daylite.app/reference/form-emails.md
- https://developer.daylite.app/reference/form-search.md
- https://developer.daylite.app/reference/form-trash-details.md
- https://developer.daylite.app/reference/form-trash.md
- https://developer.daylite.app/reference/form.md
- https://developer.daylite.app/reference/forms-list.md
- https://developer.daylite.app/reference/get-subscription.md
- https://developer.daylite.app/reference/group-create.md
- https://developer.daylite.app/reference/group-edit.md
- https://developer.daylite.app/reference/group-emails.md
- https://developer.daylite.app/reference/group-extra-fields-edit.md
- https://developer.daylite.app/reference/group-extra-fields.md
- https://developer.daylite.app/reference/group-remove.md
- https://developer.daylite.app/reference/group-search.md
- https://developer.daylite.app/reference/group-trash-details.md
- https://developer.daylite.app/reference/group-trash.md
- https://developer.daylite.app/reference/group.md
- https://developer.daylite.app/reference/groups.md
- https://developer.daylite.app/reference/industries.md
- https://developer.daylite.app/reference/industry-details.md
- https://developer.daylite.app/reference/keyword-delete.md
- https://developer.daylite.app/reference/keyword.md
- https://developer.daylite.app/reference/keywords.md
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://artifacts.apis.io/daylite/openapi/daylite-roles-api-openapi.yml