Organization Management

Get Current Organization

Retrieve detailed information about the current user's organization.

Request

GET /api/v2/organization/

Authentication

Supports two authentication methods:

1. User login authentication
2. Token authentication (add Authorization: Bearer <token> to headers)

Permissions

Requires valid organization access permissions.

Response

{
    "id": "org_id",
    "name": "Organization Name",
    "description": "Organization Description",
    "created_at": "2024-01-08T10:00:00Z",
    "updated_at": "2024-01-08T10:00:00Z",
    "creator": {
        "id": "user_id",
        "username": "creator_username"
    }
}

Update Organization

Update the current organization's information.

Request

PUT /api/v2/organization/

Permissions

Only the organization creator can update organization information.

Request Parameters

Field	Type	Required	Description
name	string	No	Organization name
description	string	No	Organization description

Request Example

{
    "name": "New Organization Name",
    "description": "New Organization Description"
}

Response

Returns the updated organization information, same format as "Get Current Organization".

Error Codes

Error Code	Description
401	Unauthorized
403	Forbidden (not creator)
400	Bad Request

Organization Token Management

For organization token-related APIs, see Organization Token Management.