# Organizations

The organizations endpoint gives access to the **organizations** in the CRM.

Good to know:

* An organization must always contain a title

## Create an organization

> Creates a new organization with email, phone numbers, and metadata.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Organization.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload.jsonld_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload.jsonld_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload.jsonld"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]}],"description":"Represents an organization in the CRM with name, contact details, tags, and related people."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"EmailAddressPayload.jsonld_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload.jsonld_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload.jsonld":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Organization":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]},"EmailAddressPayload_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}}},"paths":{"/organizations":{"post":{"operationId":"api_organizations_post","tags":["Organization"],"responses":{"201":{"description":"Organization resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Organization.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Create an organization","description":"Creates a new organization with email, phone numbers, and metadata.","parameters":[],"requestBody":{"description":"The new Organization resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Organization"}},"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"required":true}}}}}
```

## List organization notes

> Retrieve all notes associated with a given organization.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"HydraCollectionBaseSchema":{"type":"object","required":["member"],"properties":{"member":{"type":"array","items":{"type":"object"}},"totalItems":{"type":"integer","minimum":0},"view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"first":{"type":"string","format":"iri-reference"},"last":{"type":"string","format":"iri-reference"},"previous":{"type":"string","format":"iri-reference"},"next":{"type":"string","format":"iri-reference"}}},"search":{"type":"object","properties":{"@type":{"type":"string"},"template":{"type":"string"},"variableRepresentation":{"type":"string"},"mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}}},"OrganizationNote.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]}],"description":"Represents a note related to an organization, such as comments or annotations."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"OrganizationNote":{"type":"object","description":"Represents a note related to an organization, such as comments or annotations.","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/organizations/{organizationId}/notes":{"get":{"operationId":"api_organizations_organizationIdnotes_get_collection","tags":["Organization"],"responses":{"200":{"description":"OrganizationNote collection","content":{"application/ld+json":{"schema":{"type":"object","description":"OrganizationNote.jsonld collection.","allOf":[{"$ref":"#/components/schemas/HydraCollectionBaseSchema"},{"type":"object","properties":{"member":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationNote.jsonld"}}}}]}},"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationNote"}}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"List organization notes","description":"Retrieve all notes associated with a given organization.","parameters":[{"name":"organizationId","in":"path","description":"OrganizationNote identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"schema":{"type":"integer","default":1},"style":"form","explode":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"schema":{"type":"integer","default":15,"minimum":0,"maximum":30},"style":"form","explode":false},{"name":"q","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"organization","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"organization[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"category.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"category.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"author.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"author.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"flagged","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"order[flagged]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[createdAt]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"createdAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false}]}}}}
```

## Get an organization

> Retrieves the details of a single organization by its ID.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Organization.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload.jsonld_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload.jsonld_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload.jsonld"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]}],"description":"Represents an organization in the CRM with name, contact details, tags, and related people."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"EmailAddressPayload.jsonld_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload.jsonld_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload.jsonld":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Organization":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]},"EmailAddressPayload_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/organizations/{id}":{"get":{"operationId":"api_organizations_id_get","tags":["Organization"],"responses":{"200":{"description":"Organization resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Organization.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Get an organization","description":"Retrieves the details of a single organization by its ID.","parameters":[{"name":"id","in":"path","description":"Organization identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}]}}}}
```

## List organizations

> Returns a filtered, paginated list of CRM organizations.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"HydraCollectionBaseSchema":{"type":"object","required":["member"],"properties":{"member":{"type":"array","items":{"type":"object"}},"totalItems":{"type":"integer","minimum":0},"view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"first":{"type":"string","format":"iri-reference"},"last":{"type":"string","format":"iri-reference"},"previous":{"type":"string","format":"iri-reference"},"next":{"type":"string","format":"iri-reference"}}},"search":{"type":"object","properties":{"@type":{"type":"string"},"template":{"type":"string"},"variableRepresentation":{"type":"string"},"mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}}},"Organization.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload.jsonld_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload.jsonld_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload.jsonld"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]}],"description":"Represents an organization in the CRM with name, contact details, tags, and related people."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"EmailAddressPayload.jsonld_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload.jsonld_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload.jsonld":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Organization":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]},"EmailAddressPayload_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/organizations":{"get":{"operationId":"api_organizations_get_collection","tags":["Organization"],"responses":{"200":{"description":"Organization collection","content":{"application/ld+json":{"schema":{"type":"object","description":"Organization.jsonld collection.","allOf":[{"$ref":"#/components/schemas/HydraCollectionBaseSchema"},{"type":"object","properties":{"member":{"type":"array","items":{"$ref":"#/components/schemas/Organization.jsonld"}}}}]}},"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Organization"}}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"List organizations","description":"Returns a filtered, paginated list of CRM organizations.","parameters":[{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"schema":{"type":"integer","default":1},"style":"form","explode":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"schema":{"type":"integer","default":15,"minimum":0,"maximum":30},"style":"form","explode":false},{"name":"q","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"owner.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"owner.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"emailAddresses.email","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"emailAddresses.email[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"tags.id","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"tags.id[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"segments.uuid","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"segments.uuid[]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"exists[archivedAt]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"boolean"},"style":"form","explode":false},{"name":"order[title.sort]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"order[owner.lastName]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false},{"name":"createdAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[after]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"createdAt[before]","in":"query","description":"","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"identifiers","in":"query","description":"Filter by identifiers (searches LinkedIn IDs, email addresses, and phone numbers)","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false},{"name":"identifiers[]","in":"query","description":"Filter by multiple identifiers","required":false,"deprecated":false,"schema":{"type":"string"},"style":"form","explode":false}]}}}}
```

## Delete organization note

> Removes or archives a note.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/organizations/{organizationId}/notes/{id}":{"delete":{"operationId":"api_organizations_organizationIdnotes_id_delete","tags":["Organization"],"responses":{"204":{"description":"OrganizationNoteResource resource deleted"},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Delete organization note","description":"Removes or archives a note.","parameters":[{"name":"organizationId","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}]}}}}
```

## Update organization note

> Updates selected fields of a note.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"OrganizationNoteResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"OrganizationNoteResource":{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}},"OrganizationNoteResource.jsonMergePatch":{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}}}}},"paths":{"/organizations/{organizationId}/notes/{id}":{"patch":{"operationId":"api_organizations_organizationIdnotes_id_patch","tags":["Organization"],"responses":{"200":{"description":"OrganizationNoteResource resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Update organization note","description":"Updates selected fields of a note.","parameters":[{"name":"organizationId","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated OrganizationNoteResource resource","content":{"application/merge-patch+json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource.jsonMergePatch"}}},"required":true}}}}}
```

## Replace organization note

> Fully replaces a note record by ID.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"OrganizationNoteResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"OrganizationNoteResource":{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}}},"paths":{"/organizations/{organizationId}/notes/{id}":{"put":{"operationId":"api_organizations_organizationIdnotes_id_put","tags":["Organization"],"responses":{"200":{"description":"OrganizationNoteResource resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Replace organization note","description":"Fully replaces a note record by ID.","parameters":[{"name":"organizationId","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated OrganizationNoteResource resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource"}},"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource"}}},"required":true}}}}}
```

## Retrieve organization note

> Returns a single note belonging to an organization.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"OrganizationNoteResource.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]}]},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"OrganizationNoteResource":{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}}}},"paths":{"/organizations/{organizationId}/notes/{id}":{"get":{"operationId":"api_organizations_organizationIdnotes_id_get","tags":["Organization"],"responses":{"200":{"description":"OrganizationNoteResource resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationNoteResource"}}}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}}},"summary":"Retrieve organization note","description":"Returns a single note belonging to an organization.","parameters":[{"name":"organizationId","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false},{"name":"id","in":"path","description":"OrganizationNoteResource identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}]}}}}
```

## Replace an organization

> Replaces all updatable fields of the organization.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Organization.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload.jsonld_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload.jsonld_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload.jsonld"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]}],"description":"Represents an organization in the CRM with name, contact details, tags, and related people."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"EmailAddressPayload.jsonld_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload.jsonld_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload.jsonld":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Organization":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]},"EmailAddressPayload_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}}},"paths":{"/organizations/{id}":{"put":{"operationId":"api_organizations_id_put","tags":["Organization"],"responses":{"200":{"description":"Organization resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Organization.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Replace an organization","description":"Replaces all updatable fields of the organization.","parameters":[{"name":"id","in":"path","description":"Organization identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated Organization resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Organization"}},"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"required":true}}}}}
```

## Create a new organization note

> Adds a new note to the given organization.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"OrganizationNote.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]}],"description":"Represents a note related to an organization, such as comments or annotations."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"OrganizationNote":{"type":"object","description":"Represents a note related to an organization, such as comments or annotations.","properties":{"id":{"type":["string","null"]},"organizationId":{"writeOnly":true,"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"description":{"type":["string","null"]},"title":{"type":["string","null"]},"flagged":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"author":{"type":["string","null"],"format":"iri-reference"},"category":{"type":["string","null"],"format":"iri-reference"}},"required":["description","category"]},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}}},"paths":{"/organizations/{organizationId}/notes":{"post":{"operationId":"api_organizations_organizationIdnotes_post","tags":["Organization"],"responses":{"201":{"description":"OrganizationNote resource created","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganizationNote.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationNote"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Create a new organization note","description":"Adds a new note to the given organization.","parameters":[{"name":"organizationId","in":"path","description":"OrganizationNote identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The new OrganizationNote resource","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/OrganizationNote"}},"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationNote"}}},"required":true}}}}}
```

## Partially update an organization

> Updates one or more fields of the organization.

```json
{"openapi":"3.1.0","info":{"title":"RogerRoger API","version":"1.0.0"},"tags":[{"name":"Organization","description":"Represents an organization in the CRM with name, contact details, tags, and related people."}],"servers":[{"url":"https://api.rogerroger.io","description":"API"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your API key, available from the dashboard","name":"X-API-KEY","in":"header"}},"schemas":{"Organization.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload.jsonld_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload.jsonld_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload.jsonld"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]}],"description":"Represents an organization in the CRM with name, contact details, tags, and related people."},"HydraItemBaseSchema":{"type":"object","properties":{"@context":{"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http://www.w3.org/ns/hydra/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"type":"string"},"@type":{"type":"string"}},"required":["@id","@type"]},"EmailAddressPayload.jsonld_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload.jsonld_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload.jsonld":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Organization":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}},"required":["title"]},"EmailAddressPayload_noid":{"type":"object","required":["email"],"properties":{"email":{"format":"email","type":["string","null"]}}},"PhoneNumberPayload_noid":{"type":"object","required":["phoneNumber","phoneType"],"properties":{"phoneNumber":{"type":["string","null"]},"phoneType":{"enum":["fax","mobile","home","work"],"type":["string","null"]}}},"AddressPayload":{"type":"object","properties":{"city":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"street":{"type":["string","null"]},"country":{"default":"NL","type":["string","null"]}}},"Error.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"},"description":{"readOnly":true,"type":["string","null"]}}}],"description":"A representation of common errors."},"Error":{"type":"object","description":"A representation of common errors.","properties":{"title":{"readOnly":true,"description":"A short, human-readable summary of the problem.","type":["string","null"]},"detail":{"readOnly":true,"description":"A human-readable explanation specific to this occurrence of the problem.","type":["string","null"]},"status":{"type":"number","default":400},"instance":{"readOnly":true,"description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","type":["string","null"]},"type":{"readOnly":true,"description":"A URI reference that identifies the problem type","type":"string"}}},"ConstraintViolation.jsonld":{"allOf":[{"$ref":"#/components/schemas/HydraItemBaseSchema"},{"type":"object","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"description":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}}],"description":"Unprocessable entity"},"ConstraintViolation":{"type":"object","description":"Unprocessable entity","properties":{"status":{"default":422,"type":"integer"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","description":"The property path of the violation"},"message":{"type":"string","description":"The message associated with the violation"}}}},"detail":{"readOnly":true,"type":"string"},"type":{"readOnly":true,"type":"string"},"title":{"readOnly":true,"type":["string","null"]},"instance":{"readOnly":true,"type":["string","null"]}}},"Organization.jsonMergePatch":{"type":"object","description":"Represents an organization in the CRM with name, contact details, tags, and related people.","properties":{"description":{"type":["string","null"]},"emailAddresses":{"type":"array","items":{"$ref":"#/components/schemas/EmailAddressPayload_noid"}},"phoneNumbers":{"type":"array","items":{"$ref":"#/components/schemas/PhoneNumberPayload_noid"}},"title":{"type":["string","null"]},"website":{"type":["string","null"]},"customerId":{"type":["string","null"]},"externalSource":{"type":["string","null"]},"chamberOfCommerceNumber":{"type":["string","null"]},"linkedinId":{"type":["string","null"]},"linkedinPublicIdentifier":{"readOnly":true,"type":["string","null"]},"linkedinInternalId":{"readOnly":true,"type":["string","null"]},"createdAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"importedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"updatedAt":{"readOnly":true,"type":["string","null"],"format":"date-time"},"archivedAt":{"type":["string","null"],"format":"date-time"},"address":{"$ref":"#/components/schemas/AddressPayload"},"owner":{"type":["string","null"],"format":"iri-reference"},"people":{"type":"array","items":{"type":"string","format":"iri-reference"}},"avatarUrl":{"readOnly":true,"type":["string","null"]},"avatar":{"writeOnly":true,"type":["string","null"],"format":"iri-reference"},"tags":{"type":"array","items":{"type":"string","format":"iri-reference"}},"segments":{"type":"array","items":{"type":"string","format":"iri-reference"}},"integrationParticipants":{"type":"array","items":{"type":"string","format":"iri-reference"}},"companyEnrichment":{"readOnly":true,"type":["boolean","null"]},"linkedinCompanyEnrichment":{"readOnly":true,"type":["array","null"],"items":{"type":"null"}},"id":{"type":["string","null"]}}}}},"paths":{"/organizations/{id}":{"patch":{"operationId":"api_organizations_id_patch","tags":["Organization"],"responses":{"200":{"description":"Organization resource updated","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Organization.jsonld"}},"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"links":{}},"400":{"description":"Invalid input","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"403":{"description":"Forbidden","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"404":{"description":"Not found","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/Error.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"links":{}},"422":{"description":"An error occurred","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation.jsonld"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConstraintViolation"}}},"links":{}}},"summary":"Partially update an organization","description":"Updates one or more fields of the organization.","parameters":[{"name":"id","in":"path","description":"Organization identifier","required":true,"deprecated":false,"schema":{"type":"string"},"style":"simple","explode":false}],"requestBody":{"description":"The updated Organization resource","content":{"application/merge-patch+json":{"schema":{"$ref":"#/components/schemas/Organization.jsonMergePatch"}}},"required":true}}}}}
```


---

# 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://developer.rogerroger.io/organizations.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.