# 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}}}}}
```