Source Accounts API (1.0.0)

Download OpenAPI specification:Download

This API is an authorization tool for integrating Trend Micro Cloud One with a source control provider

GitHub Integration

Operations on GitHub source control integrations.

Create GitHub integration

post/integrations/github

Saves GitHub integration data after the Trend Micro Cloud One GitHub application has been installed.

SecurityCloudOneApiKey
Request
header Parameters
Api-Version
required
string

The API version used in this request.

Value: "v1"
Request Body schema: application/json
alias
required
string (Alias) [ 1 .. 64 ] characters ^[\w\-]*$

The custom alias for this integration

description
string (Description) <= 254 characters ^[\w\.,\s\-]*$

The custom description for this integration

installationID
required
string (InstallationID) [ 1 .. 20 ] characters ^[0-9]*$

The installation target id that GitHub gives to a specific app installation

Responses
201

The integration data was successfully created.

400

Something about your request didn't quite make sense. The error message should help you figure out what went wrong.

401

Unauthorized

403

You tried to do something that you're not allowed to do. Check your privileges to see what you're actually allowed to do. This could also mean that your token has expired.

409

This indicates a request conflict with the current state of the target resource

429

You have made too many requests too quickly. Check the Retry-After header for an indication of when you might be able to try again.

500

Something has gone terribly wrong. Sorry! The error message may help you figure out what went wrong, but it's unlikely that you'll be able to do anything about it unless you're the server administrator. It's possible that trying again will help, but it's more likely that you're out of luck for the moment.

503

The service is temporarily unavailable, likely due to maintenance. It should be available soon, check the Retry-After header for an indication of when you might be able to try again.

Request samples
application/json
{
  • "alias": "ABC-department-integration",
  • "description": "This integration if for the ABC department, managed by John Doe.",
  • "installationID": "123456"
}
Response samples
application/json
{
  • "alias": "ABC-department-integration",
  • "baseURL": "https://api.github.com",
  • "description": "This integration if for the ABC department, managed by John Doe.",
  • "integrationID": "ad57fdce-76b2-4745-a0e5-5474c768e42e",
  • "provider": "github",
  • "state": "managed",
  • "lastModified": "2022-07-19T21:33:00Z"
}
➔ Next to GitHub Integration