CodeSign Secure Documentation
  • Overview
    • About CodeSign Secure
    • Getting Started
    • Documentation Guide
    • Portal Overview
    • Troubleshooting
      • FAQ
    • Glossary
  • Reference Guide
    • Header Bar
      • CodeSign Secure Documentation
      • Swagger API
      • Profile Section
    • Dashboard
      • Key Performance Indicators
      • Issued Certificates
      • Signatures Generated
      • HSM Health Check
    • Keys and Certificates
      • Key and Certificate Lifecycle
    • App Management
    • Signing Requests
      • Approval Workflows
    • Signing Tools
    • Reports
      • Signing Request Report
      • Audit Trail
      • Certificate Report
      • Client Report
    • Logs
    • System Setup
      • Identity Store
      • Backup
      • User
      • Roles and Permissions
      • Email
      • Signing Projects
      • SSL/TLS Management
      • Environment
      • Plugins
  • Setup & Architecture
    • Identity and Access Control
    • Architecture and Concepts
    • Installation
      • Windows
        • Installing the Server
        • Ports and Protocols
        • High Availability and Backup
        • Upgrades and Compatibility
    • Security
      • Security Hardening Checklist
      • Client Authentication
      • Designing Signing Policies
  • Release Notes
    • Releases for 2026
      • v3.2.1
    • Releases for 2025
      • v3.2.0
    • Releases for 2024
      • v3.1.0
  • API Reference
    • Getting Started
    • Authorizing Requests
    • Securing API Access
    • Request and Response Conventions
    • Endpoint Reference
      • Signing
      • Signing Requests
      • Certificates
      • Applications and Environments
      • User Management
      • Permissions
      • Email
      • System Setup
      • Reports
      • Dashboard
      • License
  • Integration Guides
    • Signing Capabilities
      • Supported Formats and Platforms
      • Timestamping
      • Windows Signing - SignTool
        • Signing
        • Macro Signing
      • Apple Signing
      • AppX & MSIX Signing
      • Visual Studio ClickOnce
      • Jar Signing
      • Sign HLK/HCK using CodeSign Secure
      • NuGet Signing
      • Mage Signing
      • Sign OVA/OVF using Encryption Consulting’s Utility Tool
      • Utility Tool for code signing
      • Container Signing
      • PKCS11 Wrapper
        • APK Signing
        • OpenSSL Signing
        • XML Signing
        • JSign Tool Signing
        • Jarsigner Signing
        • GPG2, Debian & RPM Signing
      • Reproducible Build
        • Automated Hash Validation
        • Reproducible Build Process Flow
        • Pipeline Script Components
        • Hash Validation
    • CI/CD Integration
      • GitHub Actions
      • Jenkins
      • GitLab
      • Azure DevOps
      • TeamCity
      • Bamboo
      • Securing CI/CD Credentials

Applications and Environments

The Applications and Environments endpoints manage applications, teams, and the certificates each team holds, and the environments and approval policies that decide whether signing needs approval.

For the corresponding user interface, refer to the App Management section.

Endpoints

MethodEndpointDescription
GET/project_manage/ApprovalDetailsByEnvId/{env_id}/List approval policy for an environment
POST/project_manage/ApprovalDetailsByEnvId/{env_id}/Add an approval level to an environment
GET/project_manage/ApprovalDetailsByEnvMappingId/{env_cert_mapping_id}/List approval policy for a mapping
POST/project_manage/ApprovalDetailsByEnvMappingId/{env_cert_mapping_id}/Add an approval level to a mapping
GET/project_manage/approval/List approval policies
POST/project_manage/approval/Create an approval policy
GET/project_manage/approval/{id}/Get an approval policy
PUT/project_manage/approval/{id}/Replace an approval policy
PATCH/project_manage/approval/{id}/Update an approval policy
GET/project_manage/approver_master/List approver types
POST/project_manage/approver_master/Create an approver type
GET/project_manage/approver_master/{id}/Get an approver type
PUT/project_manage/approver_master/{id}/Replace an approver type
PATCH/project_manage/approver_master/{id}/Update an approver type
GET/project_manage/approver_options/List selectable approvers
POST/project_manage/approver_options/Filter selectable approvers
GET/project_manage/basic/List applications
POST/project_manage/basic/Create an application
GET/project_manage/basic/{id}/Get an application
PUT/project_manage/basic/{id}/Replace an application
PATCH/project_manage/basic/{id}/Update an application
GET/project_manage/create_certificate/List certificates for an application
POST/project_manage/create_certificate/Attach a certificate to an application
GET/project_manage/create_certificate/{project_id}/List certificates for one application
POST/project_manage/create_certificate/{project_id}/Attach a certificate to one application
GET/project_manage/create_certificates/List certificates available to teams
POST/project_manage/create_certificates/Register a certificate for team assignment
GET/project_manage/create_certificates/{id}/List a certificate's teams
GET/project_manage/create_certificates/{id}/teams/List team assignments for a certificate
POST/project_manage/create_environment/Create an environment with its policy
PUT/project_manage/create_environment/{env_id}/Update an environment and its policy
GET/project_manage/environment/List environments
POST/project_manage/environment/Create an environment
GET/project_manage/environment/{id}/Get an environment
PUT/project_manage/environment/{id}/Replace an environment
PATCH/project_manage/environment/{id}/Update an environment
GET/project_manage/environment_details/List environments with their policy
GET/project_manage/environment_details/{env_id}/Get an environment with its policy
GET/project_manage/environment_names/List environment names
GET/project_manage/manage_environment/List environments for management
GET/project_manage/manage_environment/delete/{env_id}/Get an environment before removal
GET/project_manage/project_certificate_mapping/List certificate-to-application mappings
POST/project_manage/project_certificate_mapping/Map a certificate to an application
GET/project_manage/project_certificate_mapping/{id}/Get a certificate mapping
PUT/project_manage/project_certificate_mapping/{id}/Replace a certificate mapping
PATCH/project_manage/project_certificate_mapping/{id}/Update a certificate mapping
GET/project_manage/teams/List teams
POST/project_manage/teams/Create a team
GET/project_manage/teams/{id}/Get a team
PUT/project_manage/teams/{id}/Replace a team
PATCH/project_manage/teams/{id}/Update a team
POST/project_manage/update_certificate_teams/Set which teams hold a certificate
GET /project_manage/ApprovalDetailsByEnvId/{env_id}/

Returns the approval levels and approvers configured for one environment.

Request Parameters

NameLocated InTypeRequiredDescription
env_idPathintegerYesIdentifier of the environment.

Example Request

curl -X GET "https://<your domain>/api/project_manage/ApprovalDetailsByEnvId/<env_id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/ApprovalDetailsByEnvId/{env_id}/

Adds an approval level for one environment.

Request Parameters

NameLocated InTypeRequiredDescription
env_idPathintegerYesIdentifier of the environment.

Request Body (application/json)

FieldTypeRequiredDescription
quorumUsersarray of objectYes
levelintegerNoLevel
min_countintegerNoMin count
env_cert_mapping_idintegerNoEnv cert mapping id
env_idintegerYesEnv id
ApproverTypeIDintegerYesApproverTypeID

Example Request

curl -X POST "https://<your domain>/api/project_manage/ApprovalDetailsByEnvId/<env_id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"quorumUsers":[],"env_id":1,"ApproverTypeID":1}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/ApprovalDetailsByEnvMappingId/{env_cert_mapping_id}/

Returns the approval levels and approvers for one certificate-and-environment mapping.

Request Parameters

NameLocated InTypeRequiredDescription
env_cert_mapping_idPathintegerYesIdentifier of the mapping.

Example Request

curl -X GET "https://<your domain>/api/project_manage/ApprovalDetailsByEnvMappingId/<env_cert_mapping_id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/ApprovalDetailsByEnvMappingId/{env_cert_mapping_id}/

Adds an approval level for one certificate-and-environment mapping.

Request Parameters

NameLocated InTypeRequiredDescription
env_cert_mapping_idPathintegerYesIdentifier of the mapping.

Request Body (application/json)

FieldTypeRequiredDescription
quorumUsersarray of objectYes
levelintegerNoLevel
min_countintegerNoMin count
env_cert_mapping_idintegerNoEnv cert mapping id
env_idintegerYesEnv id
ApproverTypeIDintegerYesApproverTypeID

Example Request

curl -X POST "https://<your domain>/api/project_manage/ApprovalDetailsByEnvMappingId/<env_cert_mapping_id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"quorumUsers":[],"env_id":1,"ApproverTypeID":1}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/approval/

Returns the approval policies configured for each environment, including how many approvals are required.

Example Request

curl -X GET "https://<your domain>/api/project_manage/approval/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/approval/

Defines how signing requests in an environment are approved.

Request Body (application/json)

FieldTypeRequiredDescription
quorumUsersarray of objectYes
levelintegerNoLevel
min_countintegerNoMin count
env_cert_mapping_idintegerNoEnv cert mapping id
env_idintegerYesEnv id
ApproverTypeIDintegerYesApproverTypeID

Example Request

curl -X POST "https://<your domain>/api/project_manage/approval/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"quorumUsers":[],"env_id":1,"ApproverTypeID":1}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/approval/{id}/

Returns one approval policy by identifier.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Example Request

curl -X GET "https://<your domain>/api/project_manage/approval/<id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
PUT /project_manage/approval/{id}/

Replaces a policy. Send the full set of fields.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Request Body (application/json)

FieldTypeRequiredDescription
quorumUsersarray of objectYes
levelintegerNoLevel
min_countintegerNoMin count
env_cert_mapping_idintegerNoEnv cert mapping id
env_idintegerYesEnv id
ApproverTypeIDintegerYesApproverTypeID

Example Request

curl -X PUT "https://<your domain>/api/project_manage/approval/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"quorumUsers":[],"env_id":1,"ApproverTypeID":1}'

Responses

Status CodeDescription
200The record after the update.
PATCH /project_manage/approval/{id}/

Updates selected fields. Send only the fields to change.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Request Body (application/json)

FieldTypeRequiredDescription
quorumUsersarray of objectYes
levelintegerNoLevel
min_countintegerNoMin count
env_cert_mapping_idintegerNoEnv cert mapping id
env_idintegerYesEnv id
ApproverTypeIDintegerYesApproverTypeID

Example Request

curl -X PATCH "https://<your domain>/api/project_manage/approval/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"quorumUsers":[],"env_id":1,"ApproverTypeID":1}'

Responses

Status CodeDescription
200The record after the update.
GET /project_manage/approver_master/

Returns the approver types available when building a policy, such as certificate owner, a quorum, or no approval.

Example Request

curl -X GET "https://<your domain>/api/project_manage/approver_master/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/approver_master/

Adds an approver type.

Request Body (application/json)

FieldTypeRequiredDescription
ApproverTypeintegerNoApproverType
ApproverTypeNamestringYesApproverTypeName
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted

Example Request

curl -X POST "https://<your domain>/api/project_manage/approver_master/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"ApproverTypeName":"string"}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/approver_master/{id}/

Returns one approver type by identifier.

Request Parameters

NameLocated InTypeRequiredDescription
idPathintegerYesA unique integer value identifying this env approval types_ table.

Example Request

curl -X GET "https://<your domain>/api/project_manage/approver_master/<id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
PUT /project_manage/approver_master/{id}/

Replaces an approver type. Send the full set of fields.

Request Parameters

NameLocated InTypeRequiredDescription
idPathintegerYesA unique integer value identifying this env approval types_ table.

Request Body (application/json)

FieldTypeRequiredDescription
ApproverTypeintegerNoApproverType
ApproverTypeNamestringYesApproverTypeName
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted

Example Request

curl -X PUT "https://<your domain>/api/project_manage/approver_master/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"ApproverTypeName":"string"}'

Responses

Status CodeDescription
200The record after the update.
PATCH /project_manage/approver_master/{id}/

Updates selected fields. Send only the fields to change.

Request Parameters

NameLocated InTypeRequiredDescription
idPathintegerYesA unique integer value identifying this env approval types_ table.

Request Body (application/json)

FieldTypeRequiredDescription
ApproverTypeintegerNoApproverType
ApproverTypeNamestringYesApproverTypeName
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted

Example Request

curl -X PATCH "https://<your domain>/api/project_manage/approver_master/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"ApproverTypeName":"string"}'

Responses

Status CodeDescription
200The record after the update.
GET /project_manage/approver_options/

Returns the users who can be named as approvers, for populating a picker.

Example Request

curl -X GET "https://<your domain>/api/project_manage/approver_options/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/approver_options/

Returns the users who can be named as approvers, narrowed by the criteria sent.

Request Body (application/json)

FieldTypeRequiredDescription
ApproverTypeintegerNoApproverType
ApproverTypeNamestringYesApproverTypeName
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted

Example Request

curl -X POST "https://<your domain>/api/project_manage/approver_options/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"ApproverTypeName":"string"}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/basic/

Returns the applications registered on the appliance.

Request Parameters

NameLocated InTypeRequiredDescription
filtersQuerystringNoJSON array of {"field": .., "operator": .., "value": ..} objects, all of which must match. Fields: Application_Name, Application_Description, Created_On, Application_Owner. Text fields take equals, not_equals, contains, not_contains, starts_with or ends_with; date fields take date_is, date_is_not, date_is_before or date_is_after with a YYYY-MM-DD value. Unknown fields and operators are ignored. Application_Owner is matched against the owners' email addresses.
pageQueryintegerNo1-based page number. Defaults to 1.
countQueryintegerNoRecords per page. Defaults to 10.

Example Request

curl -X GET "https://<your domain>/api/project_manage/basic/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/basic/

Registers an application that certificates and environments can be mapped to.

Request Body (application/json)

FieldTypeRequiredDescription
project_namestringYesProject name
descriptionstringYesDescription
business_unitstringYesBusiness unit
ownerobjectYesOwner
repository_urlstring (uri)NoRepository url
artifact_typeobjectYesArtifact type
statusstringNoStatus
created_datestring (date-time)NoCreated date
Is_deletedbooleanNoIs deleted
created_userintegerNoCreated user
modified_byintegerNoModified by

Example Request

curl -X POST "https://<your domain>/api/project_manage/basic/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_name":"string","description":"string","business_unit":"string","owner":{},"artifact_type":{}}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/basic/{id}/

Returns one application by identifier.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Example Request

curl -X GET "https://<your domain>/api/project_manage/basic/<id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
PUT /project_manage/basic/{id}/

Replaces an application. Send the full set of fields.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Request Body (application/json)

FieldTypeRequiredDescription
project_namestringYesProject name
descriptionstringYesDescription
business_unitstringYesBusiness unit
ownerobjectYesOwner
repository_urlstring (uri)NoRepository url
artifact_typeobjectYesArtifact type
statusstringNoStatus
created_datestring (date-time)NoCreated date
Is_deletedbooleanNoIs deleted
created_userintegerNoCreated user
modified_byintegerNoModified by

Example Request

curl -X PUT "https://<your domain>/api/project_manage/basic/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_name":"string","description":"string","business_unit":"string","owner":{},"artifact_type":{}}'

Responses

Status CodeDescription
200The record after the update.
PATCH /project_manage/basic/{id}/

Updates selected fields. Send only the fields to change.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Request Body (application/json)

FieldTypeRequiredDescription
project_namestringYesProject name
descriptionstringYesDescription
business_unitstringYesBusiness unit
ownerobjectYesOwner
repository_urlstring (uri)NoRepository url
artifact_typeobjectYesArtifact type
statusstringNoStatus
created_datestring (date-time)NoCreated date
Is_deletedbooleanNoIs deleted
created_userintegerNoCreated user
modified_byintegerNoModified by

Example Request

curl -X PATCH "https://<your domain>/api/project_manage/basic/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_name":"string","description":"string","business_unit":"string","owner":{},"artifact_type":{}}'

Responses

Status CodeDescription
200The record after the update.
GET /project_manage/create_certificate/

Returns the certificates available to applications.

Example Request

curl -X GET "https://<your domain>/api/project_manage/create_certificate/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/create_certificate/

Creates a certificate association for an application.

Request Body (application/json)

FieldTypeRequiredDescription
need_mfabooleanNoNeed mfa
statusintegerNoStatus
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted
project_idintegerYesProject id
environment_idintegerYesEnvironment id
certificate_idintegerYesCertificate id

Example Request

curl -X POST "https://<your domain>/api/project_manage/create_certificate/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_id":1,"environment_id":1,"certificate_id":1}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/create_certificate/{project_id}/

Returns the certificates attached to one application.

Request Parameters

NameLocated InTypeRequiredDescription
project_idPathintegerYesIdentifier of the application.

Example Request

curl -X GET "https://<your domain>/api/project_manage/create_certificate/<project_id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/create_certificate/{project_id}/

Attaches a certificate to one application.

Request Parameters

NameLocated InTypeRequiredDescription
project_idPathintegerYesIdentifier of the application.

Request Body (application/json)

FieldTypeRequiredDescription
need_mfabooleanNoNeed mfa
statusintegerNoStatus
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted
project_idintegerYesProject id
environment_idintegerYesEnvironment id
certificate_idintegerYesCertificate id

Example Request

curl -X POST "https://<your domain>/api/project_manage/create_certificate/<project_id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_id":1,"environment_id":1,"certificate_id":1}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/create_certificates/

Returns the certificates that can be assigned to teams.

Example Request

curl -X GET "https://<your domain>/api/project_manage/create_certificates/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/create_certificates/

Makes a certificate assignable to teams.

Request Body (application/json)

FieldTypeRequiredDescription
certificate_namestringYesCertificate name

Example Request

curl -X POST "https://<your domain>/api/project_manage/create_certificates/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"certificate_name":"string"}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/create_certificates/{id}/

Returns the teams currently holding one certificate.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstring (uuid)YesIdentifier of the certificate.

Example Request

curl -X GET "https://<your domain>/api/project_manage/create_certificates/<id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
GET /project_manage/create_certificates/{id}/teams/

Returns the team assignments for one certificate.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstring (uuid)YesIdentifier of the certificate.

Example Request

curl -X GET "https://<your domain>/api/project_manage/create_certificates/<id>/teams/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/create_environment/

Creates an environment and, optionally, its approval policy in a single call.

Request Body (application/json)

FieldTypeRequiredDescription
environmentobjectYesThe environment to create.
policyobjectNoApproval policy for the environment. Omit to create it without one.

Example Request

curl -X POST "https://<your domain>/api/project_manage/create_environment/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"environment":{},"policy":{}}'

Responses

Status CodeDescription
200The operation completed.
PUT /project_manage/create_environment/{env_id}/

Updates an environment and its approval policy together.

Request Parameters

NameLocated InTypeRequiredDescription
env_idPathintegerYesIdentifier of the environment.

Request Body (application/json)

FieldTypeRequiredDescription
environmentobjectYesEnvironment fields to change. Fields left out keep their value, but the object itself must be present and not empty.
policyobjectYesThe policy to apply. Send {} to remove the environment's policy.

Example Request

curl -X PUT "https://<your domain>/api/project_manage/create_environment/<env_id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"environment":{},"policy":{}}'

Responses

Status CodeDescription
200The record after the update.
GET /project_manage/environment/

Returns the environments configured on the appliance, such as development, test and production.

Example Request

curl -X GET "https://<your domain>/api/project_manage/environment/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/environment/

Adds an environment that certificates and approval policy can be attached to.

Request Body (application/json)

FieldTypeRequiredDescription
Enviornment_NamestringYesEnviornment Name
statusstringNoStatus
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
Is_deletedbooleanNoIs deleted
need_mfabooleanNoNeed mfa

Example Request

curl -X POST "https://<your domain>/api/project_manage/environment/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"Enviornment_Name":"string"}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/environment/{id}/

Returns one environment by identifier.

Request Parameters

NameLocated InTypeRequiredDescription
idPathintegerYesA unique integer value identifying this environment_ table.

Example Request

curl -X GET "https://<your domain>/api/project_manage/environment/<id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
PUT /project_manage/environment/{id}/

Replaces an environment. Send the full set of fields.

Request Parameters

NameLocated InTypeRequiredDescription
idPathintegerYesA unique integer value identifying this environment_ table.

Request Body (application/json)

FieldTypeRequiredDescription
Enviornment_NamestringYesEnviornment Name
statusstringNoStatus
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
Is_deletedbooleanNoIs deleted
need_mfabooleanNoNeed mfa

Example Request

curl -X PUT "https://<your domain>/api/project_manage/environment/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"Enviornment_Name":"string"}'

Responses

Status CodeDescription
200The record after the update.
PATCH /project_manage/environment/{id}/

Updates selected fields. Send only the fields to change.

Request Parameters

NameLocated InTypeRequiredDescription
idPathintegerYesA unique integer value identifying this environment_ table.

Request Body (application/json)

FieldTypeRequiredDescription
Enviornment_NamestringYesEnviornment Name
statusstringNoStatus
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
Is_deletedbooleanNoIs deleted
need_mfabooleanNoNeed mfa

Example Request

curl -X PATCH "https://<your domain>/api/project_manage/environment/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"Enviornment_Name":"string"}'

Responses

Status CodeDescription
200The record after the update.
GET /project_manage/environment_details/

Returns each environment together with its approval policy and approvers.

Example Request

curl -X GET "https://<your domain>/api/project_manage/environment_details/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
GET /project_manage/environment_details/{env_id}/

Returns one environment together with its approval policy and approvers.

Request Parameters

NameLocated InTypeRequiredDescription
env_idPathintegerYesIdentifier of the environment.

Example Request

curl -X GET "https://<your domain>/api/project_manage/environment_details/<env_id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
GET /project_manage/environment_names/

Returns environment names, for populating a picker.

Example Request

curl -X GET "https://<your domain>/api/project_manage/environment_names/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
GET /project_manage/manage_environment/

Returns environments with the certificates and applications attached to each.

Example Request

curl -X GET "https://<your domain>/api/project_manage/manage_environment/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
GET /project_manage/manage_environment/delete/{env_id}/

Returns what is attached to an environment, so the effect of removing it can be reviewed first.

Request Parameters

NameLocated InTypeRequiredDescription
env_idPathintegerYesIdentifier of the environment.

Example Request

curl -X GET "https://<your domain>/api/project_manage/manage_environment/delete/<env_id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
GET /project_manage/project_certificate_mapping/

Returns which certificates may be used with which application and environment.

Example Request

curl -X GET "https://<your domain>/api/project_manage/project_certificate_mapping/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/project_certificate_mapping/

Permits a certificate to be used with an application in a given environment.

Request Body (application/json)

FieldTypeRequiredDescription
project_idintegerYesApplication the certificate is mapped to.
environment_idintegerYesEnvironment the mapping applies to.
certificate_idintegerYesCertificate being mapped.

Example Request

curl -X POST "https://<your domain>/api/project_manage/project_certificate_mapping/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_id":1,"environment_id":1,"certificate_id":1}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/project_certificate_mapping/{id}/

Returns one mapping by identifier.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Example Request

curl -X GET "https://<your domain>/api/project_manage/project_certificate_mapping/<id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
PUT /project_manage/project_certificate_mapping/{id}/

Replaces a mapping. Send the full set of fields.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Request Body (application/json)

FieldTypeRequiredDescription
need_mfabooleanNoNeed mfa
statusintegerNoStatus
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted
project_idintegerYesProject id
environment_idintegerYesEnvironment id
certificate_idintegerYesCertificate id

Example Request

curl -X PUT "https://<your domain>/api/project_manage/project_certificate_mapping/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_id":1,"environment_id":1,"certificate_id":1}'

Responses

Status CodeDescription
200The record after the update.
PATCH /project_manage/project_certificate_mapping/{id}/

Updates selected fields. Send only the fields to change.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstringYes

Request Body (application/json)

FieldTypeRequiredDescription
need_mfabooleanNoNeed mfa
statusintegerNoStatus
created_userintegerNoCreated user
created_datestring (date-time)NoCreated date
modified_byintegerNoModified by
Is_deletedbooleanNoIs deleted
project_idintegerYesProject id
environment_idintegerYesEnvironment id
certificate_idintegerYesCertificate id

Example Request

curl -X PATCH "https://<your domain>/api/project_manage/project_certificate_mapping/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project_id":1,"environment_id":1,"certificate_id":1}'

Responses

Status CodeDescription
200The record after the update.
GET /project_manage/teams/

Returns the teams defined on the appliance and their members. Team membership is what grants a user access to a certificate.

Example Request

curl -X GET "https://<your domain>/api/project_manage/teams/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
POST /project_manage/teams/

Creates a team and its membership.

Request Body (application/json)

FieldTypeRequiredDescription
team_namestringYesTeam name
member_idsarray of integerYes
certificate_idsarray of stringNo

Example Request

curl -X POST "https://<your domain>/api/project_manage/teams/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"string","member_ids":1,"certificate_ids":[]}'

Responses

Status CodeDescription
201The operation completed.
GET /project_manage/teams/{id}/

Returns one team by identifier.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstring (uuid)YesA UUID string identifying this team.

Example Request

curl -X GET "https://<your domain>/api/project_manage/teams/<id>/" \
  -H "Authorization: Bearer <token>"

Responses

Status CodeDescription
200The requested records.
PUT /project_manage/teams/{id}/

Replaces a team. Send the full set of fields.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstring (uuid)YesA UUID string identifying this team.

Request Body (application/json)

FieldTypeRequiredDescription
team_namestringYesTeam name
member_idsarray of integerYes
certificate_idsarray of stringNo

Example Request

curl -X PUT "https://<your domain>/api/project_manage/teams/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"string","member_ids":1,"certificate_ids":[]}'

Responses

Status CodeDescription
200The record after the update.
PATCH /project_manage/teams/{id}/

Updates selected fields. Send only the fields to change.

Request Parameters

NameLocated InTypeRequiredDescription
idPathstring (uuid)YesA UUID string identifying this team.

Request Body (application/json)

FieldTypeRequiredDescription
team_namestringYesTeam name
member_idsarray of integerYes
certificate_idsarray of stringNo

Example Request

curl -X PATCH "https://<your domain>/api/project_manage/teams/<id>/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"string","member_ids":1,"certificate_ids":[]}'

Responses

Status CodeDescription
200The record after the update.
POST /project_manage/update_certificate_teams/

Replaces the set of teams permitted to use a certificate.

Request Body (application/json)

FieldTypeRequiredDescription
certificate_idstring (uuid)YesCertificate to update.
team_listarray of string (uuid)YesIdentifiers of every team that should hold the certificate. Teams not listed lose access.

Example Request

curl -X POST "https://<your domain>/api/project_manage/update_certificate_teams/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"certificate_id":"string","team_list":[]}'

Responses

Status CodeDescription
200The operation completed.
On this Page:
Support Privacy Policy Terms of Service

Copyright Encryption Consulting LLC. All rights reserved.