Amend the given organisations details

PUT /organisations/{OrganisationId}

oAuth

Headers

x-fapi-auth-date string

The time when the PSU last logged in with the TPP. All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: Sun, 10 Sep 2017 19:43:31 UTC

Format should match the following pattern: ^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$.
x-fapi-customer-ip-address string

The PSU's IP address if the PSU is currently logged in with the TPP.
x-fapi-interaction-id string

An RFC4122 UID used as a correlation id.
x-customer-user-agent string

Indicates the user-agent that the PSU is using.

Path parameters

OrganisationId string Required

The organisation ID

Minimum length is 1, maximum length is 40. Format should match the following pattern: ^[^<>]*$.

application/json

Body Required

AddressLine1 string Required

Address line 1

Minimum length is 5, maximum length is 255. Format should match the following pattern: ^[^<>]*$.
AddressLine2 string

Address line 2

Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
City string Required

City

Minimum length is 2, maximum length is 255. Format should match the following pattern: ^[^<>]*$.
CompanyRegister string Required

Legal company register for the country, i.e. Companies House

Minimum length is 1, maximum length is 255. Format should match the following pattern: ^[^<>]*$.
Country string Required

Country

Minimum length is 2, maximum length is 255.
CountryOfRegistration string Required

Country of registration for the org

Minimum length is 2, maximum length is 255. Format should match the following pattern: ^[^<>]*$.
Flags array[string]

Unique ID of the flag

Maximum length of each is 40. Format of each should match the following pattern: ^[^<>]*$.
LegalEntityName string Required

Legal Entity name for the org. Usually the same as org name

Minimum length is 1, maximum length is 255. Format should match the following pattern: ^[^<>]*$.
LogoUri string(uri)

A compliant URI

Format should match the following pattern: ^(http://|https://).*.(svg|png|jpg|jpeg)$|(data:image/[a-zA-Z0-9;+=-]+,[A-Za-z0-9+/]*={0,2})$.
OrganisationName string Required

Minimum length is 1, maximum length is 255. Format should match the following pattern: ^[^<>]*$.
ParentOrganisationReference string

Parent Organisation Reference

Maximum length is 65535.
Postcode string Required

Postcode

Minimum length is 3, maximum length is 40. Format should match the following pattern: ^[^<>]*$.
RegisteredName string

Registered legal name

Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
RegistrationId string

Registered ID for the organisation i.e. Legal Entity identifier number

Maximum length is 40. Format should match the following pattern: ^[^<>]*$.
RegistrationNumber string Required

Company registration number from company register i.e. Companies House registration number

Minimum length is 1, maximum length is 255. Format should match the following pattern: ^[^<>]*$.
RequiresParticipantTermsAndConditionsSigning boolean

Participant Terms and Conditions Signing Required

Default value is true.
Size string

Size of the organisation

Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
Status string

Status of the directory registration of an organisation

Values are Active, Pending, or Withdrawn. Default value is Pending.

Responses

200 application/json

Full details of the organisation including warnings on a create or update operation
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
Hide response attributes Show response attributes object
- AddressLine1 string
  
  Address line 1
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- AddressLine2 string
  
  Address line 2
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- City string
  
  City
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- CompanyRegister string
  
  Legal company register for the country, i.e. Companies House
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- Country string
  
  Country
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- CountryOfRegistration string
  
  Country of registration for the org
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- CreatedOn string
  
  JSONDatetime of organisation creation.
  
  Maximum length is 30.
- Flags array[object]
  
  Hide Flags attributes Show Flags attributes object
  
  AccessLevel integer Required
  
  The access level of a flag as a number. The higher the number, the more sensitive it is
  
  Description string
  
  The description of this flag
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
  
  Name string Required
  
  The name of this flag
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
  
  Status string Required
  
  Current status of this resource
  
  Values are Active or Inactive. Default value is Active.
  
  Type string Required
  
  The type of this tag
  
  Values are Organisation, Software_Statement, or Authorisation_Server.
  
  Value string Required
  
  The value of this flag
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- LegalEntityName string
  
  Legal Entity name for the org. Usually the same as org name
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- LogoUri string(uri)
  
  A compliant URI
  
  Format should match the following pattern: ^(http://|https://).*.(svg|png|jpg|jpeg)$|(data:image/[a-zA-Z0-9;+=-]+,[A-Za-z0-9+/]*={0,2})$.
- OrganisationId string
  
  Unique ID associated with the organisation
  
  Minimum length is 1, maximum length is 40. Format should match the following pattern: ^[^<>]*$.
- OrganisationName string
  
  Name of the organisation.
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- ParentOrganisationReference string
  
  Parent Organisation Reference
  
  Maximum length is 65535. Format should match the following pattern: ^[^<>]*$.
- Postcode string
  
  Postcode
  
  Maximum length is 40. Format should match the following pattern: ^[^<>]*$.
- RegisteredName string
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- RegistrationId string
  
  Registered ID for the organisation i.e. Legal Entity identifier number
  
  Maximum length is 40. Format should match the following pattern: ^[^<>]*$.
- RegistrationNumber string
  
  Company registration number from company register i.e. Companies House registration number
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- RequiresParticipantTermsAndConditionsSigning boolean
  
  true - this organisation requires terms and conditions to be signed. false - this organisation does not require terms and conditions to be signed
- Size string
  
  Size of the organisation
  
  Maximum length is 255. Format should match the following pattern: ^[^<>]*$.
- Status string
  
  Status of the directory registration of an organisation
  
  Values are Active, Pending, or Withdrawn. Default value is Active.
400 application/json

Bad Request
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
Hide response attribute Show response attribute object
- errors array[string]
  
  Validation Error messages
401

Unauthorized
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
403

Forbidden
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
404 application/json

Not found
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
Hide response attribute Show response attribute object
- errors array[string]
  
  Validation Error messages
406

Not Acceptable
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
429

Too many requests, maximum capacity reached. Requests are now throttled.
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
500

Internal Server Error
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
502

Bad Gateway
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.
504

Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.
Hide headers attribute Show headers attribute
- x-fapi-interaction-id string
  
  An RFC4122 UID used as a correlation id.
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

PUT /organisations/{OrganisationId}

curl \
 -X PUT https://matls-api.sandbox.raidiam.io/organisations/{OrganisationId} \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -H "x-fapi-auth-date: string" \
 -H "x-fapi-customer-ip-address: string" \
 -H "x-fapi-interaction-id: string" \
 -H "x-customer-user-agent: string" \
 -d '{"AddressLine1":"string","AddressLine2":"string","City":"string","CompanyRegister":"string","Country":"string","CountryOfRegistration":"string","Flags":["f81d4fae-7dec-11d0-a765-00a0c91e6bf6"],"LegalEntityName":"string","LogoUri":"https://example.com","OrganisationName":"string","ParentOrganisationReference":"string","Postcode":"string","RegisteredName":"string","RegistrationId":"string","RegistrationNumber":"string","RequiresParticipantTermsAndConditionsSigning":true,"Size":"string","Status":"Pending"}'

Request examples

# Headers
x-fapi-auth-date: string
x-fapi-customer-ip-address: string
x-fapi-interaction-id: string
x-customer-user-agent: string

# Payload
{
  "AddressLine1": "string",
  "AddressLine2": "string",
  "City": "string",
  "CompanyRegister": "string",
  "Country": "string",
  "CountryOfRegistration": "string",
  "Flags": [
    "f81d4fae-7dec-11d0-a765-00a0c91e6bf6"
  ],
  "LegalEntityName": "string",
  "LogoUri": "https://example.com",
  "OrganisationName": "string",
  "ParentOrganisationReference": "string",
  "Postcode": "string",
  "RegisteredName": "string",
  "RegistrationId": "string",
  "RegistrationNumber": "string",
  "RequiresParticipantTermsAndConditionsSigning": true,
  "Size": "string",
  "Status": "Pending"
}

Response examples (200)

# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "AddressLine1": "string",
  "AddressLine2": "string",
  "City": "string",
  "CompanyRegister": "string",
  "Country": "string",
  "CountryOfRegistration": "string",
  "CreatedOn": "string",
  "Flags": [
    {
      "AccessLevel": 42,
      "Description": "string",
      "Name": "string",
      "Status": "Active",
      "Type": "Organisation",
      "Value": "string"
    }
  ],
  "LegalEntityName": "string",
  "LogoUri": "https://example.com",
  "OrganisationId": "string",
  "OrganisationName": "string",
  "ParentOrganisationReference": "string",
  "Postcode": "string",
  "RegisteredName": "string",
  "RegistrationId": "string",
  "RegistrationNumber": "string",
  "RequiresParticipantTermsAndConditionsSigning": true,
  "Size": "string",
  "Status": "Active"
}

Response examples (400)

# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "errors": [
    "string"
  ]
}

Response examples (404)

# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "errors": [
    "string"
  ]
}