---
title: "POST /signing-jobs"
method: POST
path: "/signing-jobs"
---

# POST /signing-jobs

`POST /signing-jobs`

Initiates a signing job to be performed on the code provided. Signing jobs are viewable by the `ListSigningJobs` operation for two years after they are performed. Note the following requirements:

*   You must create an Amazon S3 source bucket. For more information, see [Create a Bucket](http://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) in the _Amazon S3 Getting Started Guide_.
    
*   Your S3 source bucket must be version enabled.
    
*   You must create an S3 destination bucket. Code signing uses your S3 destination bucket to write your signed code.
    
*   You specify the name of the source and destination buckets when calling the `StartSigningJob` operation.
    
*   You must also specify a request token that identifies your request to code signing.
    

You can call the DescribeSigningJob and the ListSigningJobs actions after you call `StartSigningJob`.

For a Java example that shows how to use this action, see [http://docs.aws.amazon.com/acm/latest/userguide/](http://docs.aws.amazon.com/acm/latest/userguide/)

## Request body

- object
  - `source` object, required — An <code>S3Source</code> object that contains information about the S3 bucket where you saved your unsigned code.
    - `s3` object — The <code>S3Source</code> object.
      - `bucketName` string, required — Name of the S3 bucket.
      - `key` string, required — Key name of the bucket object that contains your unsigned code.
      - `version` string, required — Version of your source image in your version enabled S3 bucket.
  - `destination` object, required — Points to an <code>S3Destination</code> object that contains information about your S3 bucket.
    - `s3` object — The <code>S3Destination</code> object.
      - `bucketName` string — Name of the S3 bucket.
      - `prefix` string — An Amazon S3 prefix that you can use to limit responses to those that begin with the specified prefix.
  - `profileName` string, required — The name of the signing profile.
  - `clientRequestToken` string, required — String that identifies the signing request. All calls after the first that use this token return the same response as the first call.
  - `profileOwner` string — The AWS account ID of the signing profile owner.

## Response `200`

Success

- StartSigningJobResponse
  - `jobId` string — The ID of your signing job.
  - `jobOwner` string — The AWS account ID of the signing job owner.

## Other responses

- `480` — ValidationException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — TooManyRequestsException
- `485` — InternalServiceErrorException

---

[API](https://skmtc.net/aws/apis/signer.md) · [All operations](https://skmtc.net/aws/apis/signer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/signer/versions/bfb2a13cadf4/schema)