Organisation API

Access: Any authenticated Active user for create; Member+ for reads; Admin+ for updates. See access-control.

Manages organisation settings and details. For user and invitation management, see the User API.

Required Headers:


partner-api-key: <YOUR_PLATFORM_API_KEY>
Authorization: Bearer <USER_JWT_TOKEN>
Content-Type: application/json

Organisation Endpoints Summary

Endpoint	Method	Operation Name	Description
`/organisations`	POST	Create Organisation	Create a new organisation
`/organisations/\{org_uuid\}`	GET	Get Organisation	Get current user’s organisation details
`/organisations/\{org_uuid\}`	PUT	Update Organisation	Update organisation details

1. Create Organisation

POST /organisations

Creates a single organisation and automatically creates an active owner membership for the authenticated user.

Request Body:


{
  "org_name": "SkyNet Aerospace Pvt Ltd",
  "org_address": "123 Drone Valley, Bengaluru, India",
  "org_website": "https://skynetaero.com",
  "org_business_identifiers": {
    "type": "GSTIN",
    "identifier": "29ABCDE1234F2Z5"
  },
  "org_type": 1
}

Responses:

201 Created:


{
  "message": "Organisation created successfully",
  "data": {
    "organisation": {
      "org_id": 101,
      "org_uuid": "d5f3c10a-9f88-4f1f-a0f6-8d4b8ec02f13",
      "org_udai_id": "UDAI-ORG-0001",
      "org_name": "SkyNet Aerospace Pvt Ltd",
      "org_address": "123 Drone Valley, Bengaluru, India",
      "org_website": "https://skynetaero.com",
      "org_business_identifiers": {
        "type": "GSTIN",
        "identifier": "29ABCDE1234F2Z5"
      },
      "org_type": 1,
      "status": 1,
      "created_at": "2025-07-04T10:00:00Z",
      "updated_at": "2025-07-04T10:00:00Z"
    },
    "membership": {
      "membership_uuid": "f3e0d7d8-5568-5c8b-93f5-221ce0a428b3",
      "membership_udai_id": "UDAI-MEM-0001",
      "role": 3,
      "status": 1
    },
    "tokens": {
      "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
      "expires_in": 3600,
      "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2gvdG9rZW4...",
      "refresh_expires_in": 2592000
    }
  }
}

Note: The tokens object contains new authentication tokens that include the newly created organisation membership. Use these tokens to immediately access organisation-specific endpoints without requiring the user to re-login.

400 Bad Request: Validation errors
401 Unauthorized: Missing/invalid JWT
403 Forbidden: User is not active

2. Get Organisation Details

GET /organisations/{org_uuid}

Returns the full profile of the organisation.

Responses:

200 OK:


{
  "data": {
    "org_id": 101,
    "org_uuid": "d5f3c10a-9f88-4f1f-a0f6-8d4b8ec02f13",
    "org_udai_id": "UDAI123456",
    "org_name": "SkyNet Aerospace Pvt Ltd",
    "org_address": "123 Drone Valley, Bengaluru, India",
    "org_website": "https://skynetaero.com",
    "org_business_identifiers": {
      "type": "GSTIN",
      "identifier": "29ABCDE1234F2Z5"
    },
    "org_type": 1,
    "status": 1,
    "created_at": "2025-07-04T10:00:00Z"
  }
}

3. Update Organisation

PUT /organisations/{org_uuid}

Updates name, address, website, or business identifiers. Restricted to Admin/Owner.

Request Body:


{
  "org_name": "string",
  "org_address": "string",
  "org_website": "string",
  "org_business_identifiers": {
    "type": "enum (e.g., GSTIN, CIN, PAN)",
    "identifier": "string"
  },
  "org_type": "enum (1=Asset Manufacturer, 2=Asset Owner, 3=Airspace Manager, 4=Airspace Monitor, 5=Remote Pilot Training Organisation, 6=Type Certification Body, 7=DGCA)",
  "status": "enum (0: Unverified, 1: Active, -1: Inactive, -2: Banned)"
}

Responses:

200 OK:


{
  "message": "Organisation updated successfully",
  "data": {
    ...
  }
}

400 Bad Request:


{
  "error": "Invalid 'status' value. Must be 0, 1, -1, or -2"
}