(github)
REST APIs for managing the github integration
- checkAccess
- checkPublishingPRs
- checkPublishingSecrets
- configureCodeSamples
- configureMintlifyRepo
- configureTarget
- getAction
- getSetup
- linkGithub
- storePublishingSecrets
- triggerAction
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
await speakeasy.github.checkAccess({
org: "<value>",
repo: "<value>",
});
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubCheckAccess } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubCheckAccess.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubCheckAccess(speakeasy, {
org: "<value>",
repo: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Query hooks for fetching data.
useGithubCheckAccess,
useGithubCheckAccessSuspense,
// Utility for prefetching data during server-side rendering and in React
// Server Components that will be immediately available to client components
// using the hooks.
prefetchGithubCheckAccess,
// Utilities to invalidate the query cache for this query in response to
// mutations and other user actions.
invalidateGithubCheckAccess,
invalidateAllGithubCheckAccess,
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubCheckAccess.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.CheckGithubAccessRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<void>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const result = await speakeasy.github.checkPublishingPRs({
generateGenLockId: "<id>",
org: "<value>",
repo: "<value>",
});
// Handle the result
console.log(result);
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubCheckPublishingPRs } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubCheckPublishingPRs.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubCheckPublishingPRs(speakeasy, {
generateGenLockId: "<id>",
org: "<value>",
repo: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result);
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Query hooks for fetching data.
useGithubCheckPublishingPRs,
useGithubCheckPublishingPRsSuspense,
// Utility for prefetching data during server-side rendering and in React
// Server Components that will be immediately available to client components
// using the hooks.
prefetchGithubCheckPublishingPRs,
// Utilities to invalidate the query cache for this query in response to
// mutations and other user actions.
invalidateGithubCheckPublishingPRs,
invalidateAllGithubCheckPublishingPRs,
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubCheckPublishingPRs.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.GithubCheckPublishingPRsRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<shared.GithubPublishingPRResponse>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const result = await speakeasy.github.checkPublishingSecrets({
generateGenLockId: "<id>",
});
// Handle the result
console.log(result);
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubCheckPublishingSecrets } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubCheckPublishingSecrets.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubCheckPublishingSecrets(speakeasy, {
generateGenLockId: "<id>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result);
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Query hooks for fetching data.
useGithubCheckPublishingSecrets,
useGithubCheckPublishingSecretsSuspense,
// Utility for prefetching data during server-side rendering and in React
// Server Components that will be immediately available to client components
// using the hooks.
prefetchGithubCheckPublishingSecrets,
// Utilities to invalidate the query cache for this query in response to
// mutations and other user actions.
invalidateGithubCheckPublishingSecrets,
invalidateAllGithubCheckPublishingSecrets,
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubCheckPublishingSecrets.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.GithubCheckPublishingSecretsRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<shared.GithubMissingPublishingSecretsResponse>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const result = await speakeasy.github.configureCodeSamples({
org: "<value>",
repo: "<value>",
targetName: "<value>",
});
// Handle the result
console.log(result);
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubConfigureCodeSamples } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubConfigureCodeSamples.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubConfigureCodeSamples(speakeasy, {
org: "<value>",
repo: "<value>",
targetName: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result);
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Mutation hook for triggering the API call.
useGithubConfigureCodeSamplesMutation
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubConfigureCodeSamples.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
shared.GithubConfigureCodeSamplesRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<shared.GithubConfigureCodeSamplesResponse>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
await speakeasy.github.configureMintlifyRepo({
input: "<value>",
org: "<value>",
overlays: [
"<value>",
],
repo: "<value>",
});
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubConfigureMintlifyRepo } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubConfigureMintlifyRepo.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubConfigureMintlifyRepo(speakeasy, {
input: "<value>",
org: "<value>",
overlays: [
"<value>",
],
repo: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Mutation hook for triggering the API call.
useGithubConfigureMintlifyRepoMutation
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubConfigureMintlifyRepo.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
shared.GithubConfigureMintlifyRepoRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<void>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
await speakeasy.github.configureTarget({
org: "<value>",
repoName: "<value>",
});
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubConfigureTarget } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubConfigureTarget.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubConfigureTarget(speakeasy, {
org: "<value>",
repoName: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Mutation hook for triggering the API call.
useGithubConfigureTargetMutation
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubConfigureTarget.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
shared.GithubConfigureTargetRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<void>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const result = await speakeasy.github.getAction({
org: "<value>",
repo: "<value>",
});
// Handle the result
console.log(result);
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubGetAction } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubGetAction.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubGetAction(speakeasy, {
org: "<value>",
repo: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result);
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Query hooks for fetching data.
useGithubGetAction,
useGithubGetActionSuspense,
// Utility for prefetching data during server-side rendering and in React
// Server Components that will be immediately available to client components
// using the hooks.
prefetchGithubGetAction,
// Utilities to invalidate the query cache for this query in response to
// mutations and other user actions.
invalidateGithubGetAction,
invalidateAllGithubGetAction,
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubGetAction.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.GetGitHubActionRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<shared.GithubGetActionResponse>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const result = await speakeasy.github.getSetup({
org: "<value>",
repo: "<value>",
generateGenLockId: "<id>",
});
// Handle the result
console.log(result);
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubGetSetup } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubGetSetup.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubGetSetup(speakeasy, {
org: "<value>",
repo: "<value>",
generateGenLockId: "<id>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result);
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Query hooks for fetching data.
useGithubGetSetup,
useGithubGetSetupSuspense,
// Utility for prefetching data during server-side rendering and in React
// Server Components that will be immediately available to client components
// using the hooks.
prefetchGithubGetSetup,
// Utilities to invalidate the query cache for this query in response to
// mutations and other user actions.
invalidateGithubGetSetup,
invalidateAllGithubGetSetup,
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubGetSetup.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.GetGithubSetupStateRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<shared.GithubSetupStateResponse>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
await speakeasy.github.linkGithub({});
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubLinkGithub } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubLinkGithub.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubLinkGithub(speakeasy, {});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Mutation hook for triggering the API call.
useGithubLinkGithubMutation
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubLinkGithub.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.LinkGithubAccessRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<void>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
await speakeasy.github.storePublishingSecrets({
generateGenLockId: "<id>",
});
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubStorePublishingSecrets } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubStorePublishingSecrets.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubStorePublishingSecrets(speakeasy, {
generateGenLockId: "<id>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Mutation hook for triggering the API call.
useGithubStorePublishingSecretsMutation
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubStorePublishingSecrets.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
shared.GithubStorePublishingSecretsRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<void>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |
import { Speakeasy } from "@speakeasy-api/speakeasy-client-sdk-typescript";
const speakeasy = new Speakeasy({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
await speakeasy.github.triggerAction({
genLockId: "<id>",
org: "<value>",
repoName: "<value>",
});
}
run();
The standalone function version of this method:
import { SpeakeasyCore } from "@speakeasy-api/speakeasy-client-sdk-typescript/core.js";
import { githubTriggerAction } from "@speakeasy-api/speakeasy-client-sdk-typescript/funcs/githubTriggerAction.js";
// Use `SpeakeasyCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const speakeasy = new SpeakeasyCore({
security: {
apiKey: "<YOUR_API_KEY_HERE>",
},
});
async function run() {
const res = await githubTriggerAction(speakeasy, {
genLockId: "<id>",
org: "<value>",
repoName: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
}
run();
This method can be used in React components through the following hooks and associated utilities.
Check out this guide for information about each of the utilities below and how to get started using React hooks.
import {
// Mutation hook for triggering the API call.
useGithubTriggerActionMutation
} from "@speakeasy-api/speakeasy-client-sdk-typescript/react-query/githubTriggerAction.js";
Parameter | Type | Required | Description |
---|---|---|---|
request |
shared.GithubTriggerActionRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<void>
Error Type | Status Code | Content Type |
---|---|---|
errors.ErrorT | 4XX | application/json |
errors.SDKError | 5XX | */* |