Skip to main content
Documentation

Organizations API

Actions in the organizations namespace of the Nexigon Hub API.

organizations_Query

POST/api/v1/actions/invoke/organizations_Query

Query the organizations of the instance.

Request QueryOrganizationsAction

No fields.

Response QueryOrganizationsOutput

  • organizationsrequired

    List of organizations.

    array<QueryOrganizationsItem>
    QueryOrganizationsItem
    • organizationId(from organization_id)required

      ID of the organization.

      OrganizationIdstring
    • namerequired

      Name of the organization.

      string

organizations_QueryMembers

POST/api/v1/actions/invoke/organizations_QueryMembers

Query the members of an organization.

Request QueryOrganizationMembersAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring

Response QueryOrganizationMembersOutput

  • membersrequired

    List of members.

    array<QueryOrganizationMembersItem>
    QueryOrganizationMembersItem
    • userId(from user_id)required

      ID of the user.

      UserIdstring
    • displayName(from display_name)optional

      Name of the user.

      string
    • emailrequired

      Email of the user.

      string
    • isAdmin(from is_admin)required

      Whether the user is an administrator of the organization.

      boolean

organizations_QueryProjects

POST/api/v1/actions/invoke/organizations_QueryProjects

Query the projects of an organization.

Request QueryOrganizationProjectsAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring

Response QueryOrganizationProjectsOutput

  • projectsrequired

    List of projects.

    array<QueryOrganizationProjectsItem>
    QueryOrganizationProjectsItem
    • projectId(from project_id)required

      ID of the project.

      ProjectIdstring
    • namerequired

      Name of the project.

      string

organizations_QueryRepositories

POST/api/v1/actions/invoke/organizations_QueryRepositories

Query the repositories of an organization.

Request QueryOrganizationRepositoriesAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring

Response QueryOrganizationRepositoriesOutput

  • repositoriesrequired

    List of repositories.

    array<QueryOrganizationRepositoriesItem>
    QueryOrganizationRepositoriesItem
    • repositoryId(from repository_id)required

      ID of the repository.

      RepositoryIdstring
    • publicName(from public_name)required

      Public name of the repository.

      string
    • displayName(from display_name)optional

      Display name of the repository (if any).

      string

organizations_QueryInvitations

POST/api/v1/actions/invoke/organizations_QueryInvitations

Query the invitations of an organization.

Request QueryOrganizationInvitationsAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring

Response QueryOrganizationInvitationsOutput

  • invitationsrequired

    List of outstanding invitations.

    array<QueryOrganizationInvitationsItem>
    QueryOrganizationInvitationsItem
    • invitationId(from invitation_id)required

      ID of the invitation.

      OrganizationInvitationIdstring
    • emailrequired

      Email address of the invited user.

      string
    • invitingUserId(from inviting_user_id)optional

      ID of the inviting user.

      UserIdstring

organizations_Create

POST/api/v1/actions/invoke/organizations_Create

Create an organization.

Request CreateOrganizationAction

  • namerequired

    Name of the organization.

    string
  • adminsoptional

    Admins of the organization.

    array<UserId>
    UserIdstring
  • requiresSubscription(from requires_subscription)required

    Whether the organization requires a subscription.

    boolean

Response CreateOrganizationOutput

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring

organizations_Delete

POST/api/v1/actions/invoke/organizations_Delete

Delete an organization.

Request DeleteOrganizationAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring

Response Empty

No fields.

organizations_AddMember

POST/api/v1/actions/invoke/organizations_AddMember

Add a user to an organization.

Request AddOrganizationMemberAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring
  • userId(from user_id)required

    ID of the user to add.

    UserIdstring
  • isAdmin(from is_admin)optional

    Whether the user should be an administrator of the organization.

    boolean

Response Empty

No fields.

organizations_RemoveMember

POST/api/v1/actions/invoke/organizations_RemoveMember

Remove a user from an organization.

Request RemoveOrganizationMemberAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring
  • userId(from user_id)required

    ID of the user.

    UserIdstring

Response Empty

No fields.

organizations_SetMemberIsAdmin

POST/api/v1/actions/invoke/organizations_SetMemberIsAdmin

Set whether the user is an administrator of the organization.

Request SetOrganizationMemberIsAdminAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring
  • userId(from user_id)required

    ID of the user.

    UserIdstring
  • isAdmin(from is_admin)required

    Whether the user should be an administrator of the organization.

    boolean

Response Empty

No fields.

organizations_InviteMember

POST/api/v1/actions/invoke/organizations_InviteMember

Invite a user to an organization.

Request InviteOrganizationMemberAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring
  • emailrequired

    Email address of the user to invite.

    string

Response InviteOrganizationMemberOutput

  • invitationId(from invitation_id)required

    ID of the invitation.

    OrganizationInvitationIdstring

organizations_DeleteInvitation

POST/api/v1/actions/invoke/organizations_DeleteInvitation

Delete an invitation to an organization.

Request DeleteOrganizationInvitationAction

  • invitationId(from invitation_id)required

    ID of the invitation.

    OrganizationInvitationIdstring

Response Empty

No fields.

organizations_QueryAuditLog

POST/api/v1/actions/invoke/organizations_QueryAuditLog

Query the audit log of an organization.

Request QueryOrganizationAuditLogAction

  • organizationId(from organization_id)required

    ID of the organization.

    OrganizationIdstring

Response QueryOrganizationAuditLogOutput

  • eventsrequired

    List of audit log events.

    array<AuditLogEvent>
    AuditLogEvent
    • eventId(from event_id)required

      ID of the audit log event.

      AuditLogEventIdstring
    • actorrequired

      Actor causing the event.

      Actor
      • Anonymous

        An anonymous, unauthenticated actor.

        { "actor": "Anonymous", ...<payload fields> } β€” or "content" for non-object payloads

        AnonymousActor

        No fields.

      • System

        The system itself, typically used for internal actions.

        { "actor": "System", ...<payload fields> } β€” or "content" for non-object payloads

        SystemActor

        No fields.

      • Device

        A device authenticated via a specific deployment token.

        { "actor": "Device", ...<payload fields> } β€” or "content" for non-object payloads

        DeviceActor
        • deviceId(from device_id)required

          ID of the device.

          DeviceIdstring
        • tokenId(from token_id)required

          ID of the deployment token used for authentication.

          DeploymentTokenIdstring
      • User

        A user typically authenticated via a user session.

        { "actor": "User", ...<payload fields> } β€” or "content" for non-object payloads

        UserActor
        • userId(from user_id)required

          ID of the user.

          UserIdstring
      • UserToken

        A user authenticated via a specific token.

        { "actor": "UserToken", ...<payload fields> } β€” or "content" for non-object payloads

        UserTokenActor
        • userId(from user_id)required

          ID of the user.

          UserIdstring
        • tokenId(from token_id)required

          ID of the user token used for authentication.

          UserTokenIdstring
      • ClusterNode

        A cluster node.

        { "actor": "ClusterNode", ...<payload fields> } β€” or "content" for non-object payloads

        ClusterNodeActor
        • nodeId(from node_id)required

          ID of the cluster node.

          ClusterNodeIdstring
      • OrganizationApiToken

        An organization API token.

        { "actor": "OrganizationApiToken", ...<payload fields> } β€” or "content" for non-object payloads

        OrganizationApiTokenActor
        • organizationId(from organization_id)required

          ID of the organization.

          OrganizationIdstring
        • tokenId(from token_id)required

          ID of the API token.

          OrganizationApiTokenIdstring
    • eventrequired

      Type of the event that was recorded.

      string
    • datarequired

      Additional audit data associated with the event.

      JsonValueany
    • createdAt(from created_at)required

      Timestamp indicating when the audit log event was recorded.

      Timestampstring
    • actionoptional

      Action the event has been caused by (if any).

      AuditLogEventAction
      • actionId(from action_id)required

        ID of the action.

        AuditLogActionIdstring
    • joboptional

      Job the event has been caused by (if any).

      AuditLogEventJob
      • jobId(from job_id)required

        ID of the job.

        JobIdstring