> ## Documentation Index
> Fetch the complete documentation index at: https://docs.schedo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Go Quickstart

> Get started with Schedo.dev using Go

The Schedo Go SDK provides a type-safe and intuitive way to interact with the Schedo API from your Go applications.

## Installation

Install the SDK using Go modules:

```bash theme={null}
go get -u github.com/useschedo/golang-sdk
```

## Authentication

First, create a Schedo client with your API key:

```go theme={null}
import (
    "github.com/useschedo/golang-sdk"
    "github.com/useschedo/golang-sdk/option"
)

client := schedo.NewClient(
    option.WithAPIKey("your_api_key"), // defaults to os.LookupEnv("SCHEDO_API_KEY")
)
```

## Defining a Job

Here's how to define a new job using the SDK:

```go theme={null}
package main

import (
    "context"
    "fmt"
    schedo "github.com/useschedo/golang"
)

func main() {
    client := schedo.NewClient(
        option.WithAPIKey("your_api_key"),
    )

    // Define a new job
   err := client.DefineJob(
		"example_job",
		"* * * * *", // Run every minute
		func(ctx *schedo.JobExecutionContext) (string, error) {
			fmt.Println("Executing job...")
			return "Job completed successfully", nil
		},
        schedo.WithTimeout(30*time.Second), // Optional: 30 second timeout
	    schedo.WithMetadata(map[string]any{"category": "reports"}), // Optional: adds metadata
	    schedo.WithBlocking(true), // Optional: makes job execution blocking
	)

	if err != nil {
		fmt.Printf("Failed to define job: %v\n", err)
		return
	}

	// Start listening for job execution events
	sdk.Start()
}
```

## Best Practices

1. **Context Usage**: Use job execution context to get more details about the job
   ```go theme={null}
   func(ctx *schedo.JobExecutionContext) (string, error) {
        fmt.Println("Execution ID: ", ctx.ExecutionID)
        return "Job completed successfully", nil
   }
   ```
2. **Error Handling**: Always check for errors and handle them appropriately:
   ```go theme={null}
   if err != nil {
       log.Printf("Failed to create job: %v", err)
       return
   }
   ```