# Authorize Repo Connection

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Authorize Repo Connection"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v2/skills/repo-connection/authorize"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Start connecting the organization's GitHub skills repository.

Returns a GitHub App installation URL carrying a signed, short-lived ``state``. The admin opens it
(in a new tab) to grant access; GitHub then redirects to the callback endpoint, which persists the
connection.

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"content":{"application/json":{"schema":{"description":"Where to send the admin's browser to install the GitHub App on their repo.","properties":{"install_url":{"description":"GitHub App installation URL the admin should be redirected to.","title":"Install Url","type":"string"}},"required":["install_url"],"title":"RepoConnectionAuthorizeResponse","type":"object"}}},"description":"Returns a GitHub App installation URL. Open it to grant deepset access to your skills repository."},"422":{"content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"ctx":{"title":"Context","type":"object"},"input":{"title":"Input"},"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"}}},"description":"Validation Error"},"503":{"description":"The GitHub App is not configured, so a connection can't be started."}}}
>
  
</StatusCodes>